Namespaces - Create Or Update Authorization Rule

Serviço:: Notification Hubs

Versão da API:: 2023-09-01

Cria uma regra de autorização para um namespace

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NotificationHubs/namespaces/{namespaceName}/authorizationRules/{authorizationRuleName}?api-version=2023-09-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
authorizationRuleName	path	True	string minLength: 1 maxLength: 256 pattern: ^[a-zA-Z0-9!()*-._]+$	Nome da regra de autorização
namespaceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z][a-zA-Z0-9-]*$	Nome do Namespace
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
location	string	Preterido - somente para compatibilidade.
properties	SharedAccessAuthorizationRuleProperties	Propriedades SharedAccessAuthorizationRule.
tags	object	Preterido - somente para compatibilidade.

Respostas

Nome	Tipo	Description
200 OK	SharedAccessAuthorizationRuleResource	Atualizado
201 Created	SharedAccessAuthorizationRuleResource	Criado
Other Status Codes	ErrorResponse	Código de erro com motivo.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Namespaces_CreateOrUpdateAuthorizationRule

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/authorizationRules/sdk-AuthRules-1788?api-version=2023-09-01

{
  "properties": {
    "rights": [
      "Listen",
      "Send"
    ]
  }
}

Resposta de exemplo

Código de status:: 200

{
  "properties": {
    "rights": [
      "Listen",
      "Send"
    ],
    "modifiedTime": "2023-04-26T10:09:19.9675121+00:00",
    "createdTime": "2023-04-26T10:09:19.9675121+00:00"
  },
  "id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/authorizationRules/NewAuthorizationRule",
  "name": "NewAuthorizationRule",
  "type": "Microsoft.NotificationHubs/namespaces/authorizationRules"
}

Código de status:: 201

{
  "properties": {
    "rights": [
      "Listen",
      "Send"
    ],
    "modifiedTime": "2023-04-26T10:09:19.9675121+00:00",
    "createdTime": "2023-04-26T10:09:19.9675121+00:00"
  },
  "id": "/subscriptions/29cfa613-cbbc-4512-b1d6-1b3a92c7fa40/resourceGroups/5ktrial/providers/Microsoft.NotificationHubs/namespaces/nh-sdk-ns/authorizationRules/NewAuthorizationRule",
  "name": "NewAuthorizationRule",
  "type": "Microsoft.NotificationHubs/namespaces/authorizationRules"
}

Definições

Nome	Description
AccessRights	Define valores para AccessRights.
createdByType	O tipo de identidade que criou o recurso.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
SharedAccessAuthorizationRuleProperties	Propriedades SharedAccessAuthorizationRule.
SharedAccessAuthorizationRuleResource	Resposta para solicitações POST que retornam SharedAccessAuthorizationRule único.
systemData	Metadados relativos à criação e última modificação do recurso.

AccessRights

Enumeração

Define valores para AccessRights.

Valor	Description
Manage
Send
Listen

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

SharedAccessAuthorizationRuleProperties

Objeto

Propriedades SharedAccessAuthorizationRule.

Nome	Tipo	Description
claimType	string	Obtém uma cadeia de caracteres que descreve o tipo de declaração
claimValue	string	Obtém uma cadeia de caracteres que descreve o valor da declaração
createdTime	string (date-time)	Obtém o tempo criado para essa regra
keyName	string	Obtém uma cadeia de caracteres que descreve a regra de autorização.
modifiedTime	string (date-time)	Obtém a hora da última modificação para essa regra
primaryKey	string	Obtém uma chave primária de 256 bits codificada em base64 para assinar e validar o token SAS.
revision	integer (int32)	Obtém o número de revisão da regra
rights	AccessRights[]	Obtém ou define os direitos associados à regra.
secondaryKey	string	Obtém uma chave primária de 256 bits codificada em base64 para assinar e validar o token SAS.

SharedAccessAuthorizationRuleResource

Objeto

Resposta para solicitações POST que retornam SharedAccessAuthorizationRule único.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	Preterido - somente para compatibilidade.
name	string	O nome do recurso
properties	SharedAccessAuthorizationRuleProperties	Propriedades SharedAccessAuthorizationRule.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
tags	object	Preterido - somente para compatibilidade.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via

Namespaces - Create Or Update Authorization Rule

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Namespaces_CreateOrUpdateAuthorizationRule

Solicitação de exemplo

Resposta de exemplo

Definições

AccessRights

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

SharedAccessAuthorizationRuleProperties

SharedAccessAuthorizationRuleResource

systemData