Features - Register

Serviço:

Resource Management

Versão API:

2021-07-01

Registra o recurso de visualização para a assinatura.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/{resourceProviderNamespace}/features/{featureName}/register?api-version=2021-07-01

Parâmetros URI

Nome	Em	Necessário	Tipo	Descrição
featureName	path	True	string	O nome do recurso a ser registrado.
resourceProviderNamespace	path	True	string	O namespace do provedor de recursos.
subscriptionId	path	True	string	A ID de assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Descrição
200 OK	FeatureResult	OK - Retorna metadados sobre o recurso registrado. Os metadados incluem o nome do recurso, o estado de registro, a ID do recurso e o tipo de recurso. Media Types: "application/json", "text/json"
Other Status Codes	ErrorResponse	Resposta de erro descrevendo o motivo da falha na operação. Media Types: "application/json", "text/json"

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome	Descrição
user_impersonation	personificar a sua conta de utilizador

Exemplos

Register feature

Pedido de exemplo

HTTP

POST https://management.azure.com/subscriptions/subid/providers/Microsoft.Features/providers/Resource Provider Namespace/features/feature/register?api-version=2021-07-01

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.resource.features import FeatureClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-resource-features
# USAGE
    python register_feature.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = FeatureClient(
        credential=DefaultAzureCredential(),
        subscription_id="subid",
    )

    response = client.features.register(
        resource_provider_namespace="Resource Provider Namespace",
        feature_name="feature",
    )
    print(response)


# x-ms-original-file: specification/resources/resource-manager/Microsoft.Features/features/stable/2021-07-01/examples/registerFeature.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Resposta de exemplo

Código de estado:

200

{
  "name": "Feature1",
  "properties": {
    "state": "registered"
  },
  "id": "feature_id1",
  "type": "type1"
}

Definições

Nome	Descrição
ErrorDefinition	Definição de erro.
ErrorResponse	A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada.
FeatureProperties	Informações sobre o recurso.
FeatureResult	Informações de recursos visualizados.

ErrorDefinition

Objetivo

Definição de erro.

Nome	Tipo	Descrição
code	string	Código de erro específico do serviço que serve como substatus para o código de erro HTTP.
details	ErrorDefinition[]	Detalhes do erro interno.
message	string	Descrição do erro.

ErrorResponse

Objetivo

A resposta de erro indica que o serviço não é capaz de processar a solicitação de entrada.

Nome	Tipo	Descrição
error	ErrorDefinition	Os detalhes do erro.

FeatureProperties

Objetivo

Informações sobre o recurso.

Nome	Tipo	Descrição
state	string	O estado de registro do recurso para a assinatura.

FeatureResult

Objetivo

Informações de recursos visualizados.

Nome	Tipo	Descrição
id	string	A ID do recurso do recurso.
name	string	O nome do recurso.
properties	FeatureProperties	Propriedades do recurso visualizado.
type	string	O tipo de recurso do recurso.