Criar featureRolloutPolicyCreate featureRolloutPolicy

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível no v 1.0, use o seletor de versão .To determine whether an API is available in v1.0, use the Version selector.

Criar um novo objeto featureRolloutPolicy .Create a new featureRolloutPolicy object.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Policy.ReadWrite.FeatureRolloutPolicy.ReadWrite.FeatureRollout
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP request

POST /directory/featureRolloutPolicies

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AuthorizationAuthorization Portador {código}Bearer {code}

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça uma representação JSON do objeto featureRolloutPolicy .In the request body, supply a JSON representation of featureRolloutPolicy object.

A tabela a seguir mostra as propriedades que são necessárias ao criar featureRolloutPolicy.The following table shows the properties that are required when you create a featureRolloutPolicy.

ParâmetroParameter TipoType DescriçãoDescription
displayNamedisplayName stringstring O nome de exibição desta política de distribuição de recursos.The display name for this feature rollout policy.
apresentamfeature stagedFeatureNamestagedFeatureName O recurso que seria implantado usando esta política.The feature that would be rolled out using this policy.
isEnabledisEnabled stringstring Indica se a distribuição de recursos está habilitada.Indicates whether the feature rollout is enabled.

RespostaResponse

Se tiver êxito, este método retornará um 201 Created código de resposta e um novo objeto featureRolloutPolicy no corpo da resposta.If successful, this method returns a 201 Created response code and a new featureRolloutPolicy object in the response body.

ExemplosExamples

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

POST https://graph.microsoft.com/beta/directory/featureRolloutPolicies
Content-type: application/json

{
  "displayName": "PassthroughAuthentication rollout policy",
  "description": "PassthroughAuthentication rollout policy",
  "feature": "passthroughAuthentication",
  "isEnabled": true,
  "isAppliedToOrganization": false
}

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "e3c2f23a-edd2-43a8-849f-154e70794ac5",
  "displayName": "PassthroughAuthentication rollout policy",
  "description": "PassthroughAuthentication rollout policy",
  "feature": "passthroughAuthentication",
  "isEnabled": true,
  "isAppliedToOrganization": false
}