Obter propriedades do serviço Blob
Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Obter propriedades do serviço Blob

 

A palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona.

Para obter informações detalhadas sobre as regras CORS e lógica de avaliação, consulte O suporte para os serviços de armazenamento do Azure (CORS) de compartilhamento de recursos entre origens.

A palavras-chave Async e Await no Visual Basic e a palavras-chave async e await em c# são o coração da programação assíncrona. HTTPS é recomendado. Substitua <account-name> pelo nome da sua conta de armazenamento:

Método

URI de solicitação

Versão de HTTP

get

https://<account-name>.blob.core.windows.net/?restype=service&comp=properties

HTTP/1.1

Observe que o URI sempre deve incluir a barra (/) para separar o nome do host do caminho e as partes de consulta do URI. No caso dessa operação, a parte do caminho do URI fica vazia.

Parâmetro URI

Descrição

restype=service&comp=properties

Obrigatório. A combinação das duas cadeias de caracteres de consulta é necessária para obter as propriedades do serviço de armazenamento.

timeout

Opcional. O timeout parâmetro é expresso em segundos. Para obter mais informações, consulte Configurando os tempos limite para operações de serviço do Blob.

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho de solicitação

Descrição

Authorization

Obrigatório. Especifica o esquema de autenticação, o nome da conta de armazenamento e a assinatura. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

Date ou x-ms-date

Obrigatório. Especifica o Tempo Universal Coordenado (UTC) para a solicitação. Para obter mais informações, consulte Autenticação federada para os Serviços de Armazenamento do Azure.

x-ms-version

Obrigatório para todas as solicitações autenticadas. Especifica a versão da operação a ser usada para esta solicitação. Para obter mais informações, consulte Controle de versão para os serviços de armazenamento do Azure.

x-ms-client-request-id

Opcional. Fornece um valor opaco gerado pelo cliente com limite de caractere de 1 KB que será registrado nos logs de análise quando o registro em log da análise de armazenamento for habilitado. O uso desse cabeçalho é altamente recomendável para correlacionar atividades do lado do cliente com solicitações recebidas pelo servidor. Para obter mais informações, consulte Sobre o log de análise de armazenamento e log do Azure: Usando Logs para rastrear solicitações de armazenamento.

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Uma operação bem-sucedida retorna o código de status 200 (OK).

Para obter informações sobre códigos de status, consulte Status do gerenciamento de serviço e códigos de erro.

A resposta para esta operação inclui os cabeçalhos a seguir. A resposta também pode incluir cabeçalhos padrão HTTP adicionais. Todos os cabeçalhos padrão obedecem a especificação de protocolo HTTP/1.1.

Cabeçalho de resposta

Descrição

x-ms-request-id

Um valor que identifica, de maneira exclusiva, uma solicitação feita no serviço.

x-ms-version

Especifica a versão da operação usada para a resposta. Para obter mais informações, consulte Controle de versão para os serviços de armazenamento do Azure.

Para a versão 2012-02-12 e anterior, o formato da resposta é o seguinte:

<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties> <Logging> <Version>version-number</Version> <Delete>true|false</Delete> <Read>true|false</Read> <Write>true|false</Write> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </Logging> <Metrics> <Version>version-number</Version> <Enabled>true|false</Enabled> <IncludeAPIs>true|false</IncludeAPIs> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </Metrics> <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties>

A partir da versão 2013-08-15, o formato do corpo de resposta é o seguinte:


<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties> <Logging> <Version>version-number</Version> <Delete>true|false</Delete> <Read>true|false</Read> <Write>true|false</Write> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </Logging> <HourMetrics> <Version>version-number</Version> <Enabled>true|false</Enabled> <IncludeAPIs>true|false</IncludeAPIs> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </HourMetrics> <MinuteMetrics> <Version>version-number</Version> <Enabled>true|false</Enabled> <IncludeAPIs>true|false</IncludeAPIs> <RetentionPolicy> <Enabled>true|false</Enabled> <Days>number-of-days</Days> </RetentionPolicy> </MinuteMetrics> <Cors> <CorsRule> <AllowedOrigins>comma-separated-list-of-allowed-origins</AllowedOrigins> <AllowedMethods>comma-separated-list-of-HTTP-verb</AllowedMethods> <MaxAgeInSeconds>max-caching-age-in-seconds</MaxAgeInSeconds> <ExposedHeaders>comma-seperated-list-of-response-headers</ExposedHeaders> <AllowedHeaders> comma-seperated-list-of-request-headers </AllowedHeaders> </CorsRule> </Cors> <DefaultServiceVersion>default-service-version-string</DefaultServiceVersion> </StorageServiceProperties>

A tabela a seguir descreve os elementos do corpo da resposta:

Nome do elemento

Descrição

Logging

Grupos de análise do Azure log configurações.

Metrics

Grupos de análise do Azure Metrics configurações. O métricas configurações fornecem um resumo das estatísticas de solicitação agrupadas por API em agregações por hora para blobs.

HourMetrics

Grupos de análise do Azure HourMetrics configurações. O HourMetrics configurações fornecem um resumo das estatísticas de solicitação agrupadas por API em agregações por hora para blobs.

MinuteMetrics

Grupos de análise do Azure MinuteMetrics configurações. O MinuteMetrics configurações fornecem estatísticas de solicitação para cada minuto para blobs.

Version

A versão do Storage Analytics em uso no momento.

Delete

É aplicável apenas à configuração de geração de logs. Indica se as solicitações de exclusão estão sendo registradas em log.

Read

É aplicável apenas à configuração de geração de logs. Indica se as solicitações de leitura estão sendo registradas em log.

Write

É aplicável apenas à configuração de geração de logs. Indica se as solicitações de gravação estão sendo registradas em log.

Enabled

Indica se a métrica está habilitada para o serviço Blob.

Se a replicação georredundante de acesso de leitura estiver habilitada, as métricas primárias e secundárias serão coletadas. Se a replicação georredundante de acesso de leitura não estiver habilitada, apenas as métricas primárias serão coletadas.

IncludeAPIs

É aplicável apenas à configuração de métrica. Indica se a métrica gera estatísticas de resumo para operações chamadas de API.

RetentionPolicy/Enabled

Indica se uma política de retenção está habilitada para o serviço de armazenamento.

RetentionPolicy/Days

Indica o número de dias em que a métrica ou os dados de log são mantidos. Todos os dados mais antigos do que esse valor serão excluídos.

DefaultServiceVersion

DefaultServiceVersion indica a versão padrão a ser usado para solicitações ao serviço Blob se a versão de uma solicitação de entrada não for especificada. Os valores incluem a versão 2008-10-27 e mais recentes. Para obter mais informações sobre versões aplicáveis, consulte Controle de versão para os serviços de armazenamento do Azure.

Cors

Agrupa todas as regras de CORS.

CorsRule

Agrupa as configurações para uma regra de CORS.

AllowedOrigins

Uma lista de domínios de origem separados por vírgulas que são permitidos nos CORS ou “*” se todos os domínios forem permitidos.

ExposedHeaders

Uma lista de cabeçalhos de resposta separados por vírgulas para expor para clientes de CORS.

MaxAgeInSeconds

O número de segundos que o cliente/navegador deve armazenar em cache uma resposta de simulação.

AllowedHeaders

Uma lista de cabeçalhos separados por vírgulas com permissão para fazerem parte da solicitação entre origens.

AllowedMethods

Uma lista de métodos de HTTP separados por vírgulas com permissão para serem executados pela origem. Para o Armazenamento do Azure, os métodos permitidos são DELETE, GET, HEAD, MERGE, POST, OPTIONS ou PUT.

Somente o proprietário da conta de armazenamento pode chamar essa operação.

URI de exemplo a seguir faz uma solicitação para obter as propriedades do serviço Blob para a conta fictícia de armazenamento denominada myaccount:

GET https://myaccount.blob.core.windows.net/?restype=service&comp=properties HTTP/1.1

A solicitação é enviada com os seguintes cabeçalhos:

x-ms-version: 2013-08-15 x-ms-date: Wed, 23 Oct 2013 04:28:19 GMT Authorization: SharedKey myaccount:Z1lTLDwtq5o1UYQluucdsXk6/iB7YxEu0m6VofAEkUE= Host: myaccount.blob.core.windows.net

Depois que a solicitação tiver sido enviada, a resposta a seguir será retornada:

HTTP/1.1 200 OK Content-Length: 1020 Content-Type: application/xml Date: Wed, 23 Oct 2013 04:28:20 GMT Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30 x-ms-version: 2013-08-15

A resposta inclui o seguinte corpo XML:

<?xml version="1.0" encoding="utf-8"?> <StorageServiceProperties> <Logging> <Version>1.0</Version> <Delete>true</Delete> <Read>false</Read> <Write>true</Write> <RetentionPolicy> <Enabled>true</Enabled> <Days>7</Days> </RetentionPolicy> </Logging> <HourMetrics> <Version>1.0</Version> <Enabled>true</Enabled> <IncludeAPIs>false</IncludeAPIs> <RetentionPolicy> <Enabled>true</Enabled> <Days>7</Days> </RetentionPolicy> </HourMetrics> <MinuteMetrics> <Version>1.0</Version> <Enabled>true</Enabled> <IncludeAPIs>true</IncludeAPIs> <RetentionPolicy> <Enabled>true</Enabled> <Days>7</Days> </RetentionPolicy> </MinuteMetrics> <Cors> <CorsRule> <AllowedOrigins> http://www.fabrikam.com,http://www.contoso.com</AllowedOrigins> <AllowedMethods>GET,PUT</AllowedMethods> <MaxAgeInSeconds>500</MaxAgeInSeconds> <ExposedHeaders>x-ms-meta-data*,x-ms-meta-customheader</ExposedHeaders> <AllowedHeaders>x-ms-meta-target*,x-ms-meta-customheader</AllowedHeaders> </CorsRule> </Cors> <DefaultServiceVersion>2013-08-15</DefaultServiceVersion> </StorageServiceProperties>

Mostrar:
© 2016 Microsoft