Compartilhar via


Queue Services - Set Service Properties

Define as propriedades do serviço Fila de uma conta de armazenamento, incluindo as propriedades das regras de Análise de Armazenamento e CORS (Compartilhamento de Recursos entre Origens).

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/queueServices/default?api-version=2024-01-01

Parâmetros de URI

Nome Em Obrigatório Tipo Description
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-z0-9]+$

O nome da conta de armazenamento dentro do grupo de recursos especificado. Os nomes da conta de armazenamento devem ter entre 3 e 24 caracteres de comprimento e usar apenas números e letras minúsculas.

queueServiceName
path True

QueueServiceName

O nome do Serviço de Fila dentro da conta de armazenamento especificada. O Nome do Serviço de Fila deve ser 'padrão'

resourceGroupName
path True

string

minLength: 1
maxLength: 90
pattern: ^[-\w\._\(\)]+$

O nome do grupo de recursos na assinatura do usuário. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

A ID da assinatura de destino.

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
properties.cors

CorsRules

Especifica regras CORS para o serviço Fila. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule estiver incluído no corpo da solicitação, todas as regras CORS serão excluídas e o CORS será desabilitado para o serviço Fila.

Respostas

Nome Tipo Description
200 OK

QueueServiceProperties

OK -- Define as propriedades do serviço Fila de uma conta de armazenamento com êxito.

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

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

QueueServicesPut

Solicitação de exemplo

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/queueServices/default?api-version=2024-01-01

{
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    }
  }
}

Resposta de exemplo

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/res4410/providers/Microsoft.Storage/storageAccounts/sto8607/queueServices/default",
  "name": "default",
  "type": "Microsoft.Storage/storageAccounts/queueServices",
  "properties": {
    "cors": {
      "corsRules": [
        {
          "allowedOrigins": [
            "http://www.contoso.com",
            "http://www.fabrikam.com"
          ],
          "allowedMethods": [
            "GET",
            "HEAD",
            "POST",
            "OPTIONS",
            "MERGE",
            "PUT"
          ],
          "maxAgeInSeconds": 100,
          "exposedHeaders": [
            "x-ms-meta-*"
          ],
          "allowedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ]
        },
        {
          "allowedOrigins": [
            "*"
          ],
          "allowedMethods": [
            "GET"
          ],
          "maxAgeInSeconds": 2,
          "exposedHeaders": [
            "*"
          ],
          "allowedHeaders": [
            "*"
          ]
        },
        {
          "allowedOrigins": [
            "http://www.abc23.com",
            "https://www.fabrikam.com/*"
          ],
          "allowedMethods": [
            "GET",
            "PUT"
          ],
          "maxAgeInSeconds": 2000,
          "exposedHeaders": [
            "x-ms-meta-abc",
            "x-ms-meta-data*",
            "x-ms-meta-target*"
          ],
          "allowedHeaders": [
            "x-ms-meta-12345675754564*"
          ]
        }
      ]
    }
  }
}

Definições

Nome Description
AllowedMethods

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que têm permissão para serem executados pela origem.

CloudError

Uma resposta de erro do serviço de Armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de Armazenamento.

CorsRule

Especifica uma regra CORS para o serviço Blob.

CorsRules

Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

QueueServiceName

O nome do Serviço de Fila dentro da conta de armazenamento especificada. O Nome do Serviço de Fila deve ser 'padrão'

QueueServiceProperties

As propriedades do serviço Fila de uma conta de armazenamento.

AllowedMethods

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que têm permissão para serem executados pela origem.

Valor Description
CONNECT
DELETE
GET
HEAD
MERGE
OPTIONS
PATCH
POST
PUT
TRACE

CloudError

Uma resposta de erro do serviço de Armazenamento.

Nome Tipo Description
error

CloudErrorBody

Uma resposta de erro do serviço de Armazenamento.

CloudErrorBody

Uma resposta de erro do serviço de Armazenamento.

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.

details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.

message

string

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.

target

string

O destino do erro específico. Por exemplo, o nome da propriedade em erro.

CorsRule

Especifica uma regra CORS para o serviço Blob.

Nome Tipo Description
allowedHeaders

string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos permitidos para fazer parte da solicitação entre origens.

allowedMethods

AllowedMethods[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de métodos HTTP que têm permissão para serem executados pela origem.

allowedOrigins

string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de domínios de origem que serão permitidos via CORS ou "*" para permitir todos os domínios

exposedHeaders

string[]

Obrigatório se o elemento CorsRule estiver presente. Uma lista de cabeçalhos de resposta a serem expostos a clientes CORS.

maxAgeInSeconds

integer

Obrigatório se o elemento CorsRule estiver presente. O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de pré-vôo.

CorsRules

Define as regras do CORS. Você pode incluir até cinco elementos CorsRule na solicitação.

Nome Tipo Description
corsRules

CorsRule[]

A lista de regras cors. Você pode incluir até cinco elementos CorsRule na solicitação.

QueueServiceName

O nome do Serviço de Fila dentro da conta de armazenamento especificada. O Nome do Serviço de Fila deve ser 'padrão'

Valor Description
default

QueueServiceProperties

As propriedades do serviço Fila de uma conta de armazenamento.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

O nome do recurso

properties.cors

CorsRules

Especifica regras CORS para o serviço Fila. Você pode incluir até cinco elementos CorsRule na solicitação. Se nenhum elemento CorsRule estiver incluído no corpo da solicitação, todas as regras CORS serão excluídas e o CORS será desabilitado para o serviço Fila.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"