Esta página mostra como ativar, desativar e verificar o estado da funcionalidade Autoclass, que é definida num contentor no Cloud Storage.
Funções necessárias
Para receber as autorizações necessárias para definir e gerir o Autoclass num contentor,
peça ao seu administrador para lhe conceder a função de administrador do armazenamento (roles/storage.admin
)
do IAM no contentor. Esta função predefinida contém as autorizações necessárias para definir e gerir a classe automática num contentor. Para ver as autorizações exatas necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
storage.buckets.get
storage.buckets.list
- Esta autorização só é necessária para usar a Trusted Cloud consola para realizar as tarefas nesta página.
storage.buckets.update
Também pode obter estas autorizações com funções personalizadas.
Para ver informações sobre a concessão de funções em contentores, consulte o artigo Use o IAM com contentores.
Defina a classe automática para um contentor
Para definir o Autoclass para um contentor, conclua as seguintes instruções:
Consola
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Na lista de contentores, clique no nome do contentor pretendido.
Na página Detalhes do contentor, clique no separador Configuração.
Clique no ícone Editar (edit) para Classe de armazenamento predefinida.
Na janela de sobreposição, selecione Autoclass para ativar o Autoclass. Para desativar a classe automática, selecione Definir uma classe predefinida e, de seguida, selecione uma classe de armazenamento predefinida para o contentor.
Clique em Confirm.
Para alterar a classe de armazenamento terminal de um contentor com o Autoclass ativado, clique no ícone Editar (edit) para Classes incluídas e clique em Confirmar na janela de sobreposição apresentada.
Linha de comandos
Use o comando gcloud storage buckets update
com os flags adequados:
gcloud storage buckets update gs://BUCKET_NAME --default-storage-class=DEFAULT_CLASS AUTOCLASS_FLAG
Onde:
BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.DEFAULT_CLASS
define os metadados da classe de armazenamento para o contentor. Quando ativa a classe automática,STANDARD
é o único valor válido e é obrigatório se o contentor usar atualmente uma classe de armazenamento diferente.AUTOCLASS_FLAG
é uma das seguintes opções:--enable-autoclass
para ativar a classificação automática.--no-enable-autoclass
para desativar a classificação automática.--autoclass-terminal-storage-class=CLASS
para definir a classe de armazenamento do terminal para a classe automática. CLASS pode serNEARLINE
ouARCHIVE
. Quando usar esta flag num contentor com a funcionalidade Autoclass desativada, inclua também a flag--enable-autoclass
no comando.
Se for bem-sucedido, a resposta é semelhante ao seguinte exemplo:
Updating gs://my-bucket/... Completed 1
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Crie um ficheiro JSON que contenha as seguintes informações:
{ "storageClass": "DEFAULT_CLASS", "autoclass": { "enabled": BOOLEAN, "terminalStorageClass":TERMINAL_CLASS } }
Onde:
DEFAULT_CLASS
define os metadados da classe de armazenamento para o contentor. Quando ativa a classe automática,STANDARD
é o único valor válido e é obrigatório se o contentor usar atualmente uma classe de armazenamento diferente.BOOLEAN
étrue
para ativar a classe automática oufalse
para desativar a classe automática.TERMINAL_CLASS
é a classe de armazenamento terminal a usar quando a funcionalidade Autoclass está ativada.
Use
cURL
para chamar a API JSON com um pedido dePATCH
Bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=autoclass"
Onde:
JSON_FILE_NAME
é o caminho para o ficheiro JSON que criou no passo 2.BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.
API XML
Não é possível gerir esta funcionalidade através da API XML. Em alternativa, use a consolaTrusted Cloud ou outra ferramenta.
Veja o estado da funcionalidade Autoclass de um contentor
Para ver o estado da classe automática de um contentor individual:
Consola
- Na Trusted Cloud consola, aceda à página Recipientes do Cloud Storage.
Clique no nome do contentor cujo estado quer verificar.
Clique no separador Configuração.
O estado da classe automática é apresentado no campo Classe de armazenamento predefinida.
Se a classe automática estiver ativada, o campo indica Gerido com classe automática e o campo Classes incluídas apresenta as classes de armazenamento entre as quais os objetos podem transitar.
Linha de comandos
Use o comando gcloud storage buckets describe
com a flag
--format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(autoclass)"
Onde BUCKET_NAME
é o nome do contentor cuja
status quer ver. Por exemplo, my-bucket
.
Se for bem-sucedido, a resposta é semelhante ao seguinte exemplo:
autoclass: enabled: true terminalStorageClass: ARCHIVE terminalStorageClassUpdateTime: '2023-02-10T16:11:02.384000+00:00' toggleTime: '2022-11-09T16:01:40.775000+00:00'
Bibliotecas cliente
C++
Para mais informações, consulte a documentação de referência da API C++ do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
C#
Para mais informações, consulte a documentação de referência da API C# do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Go
Para mais informações, consulte a documentação de referência da API Go do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Java
Para mais informações, consulte a documentação de referência da API Java do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Node.js
Para mais informações, consulte a documentação de referência da API Node.js do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
PHP
Para mais informações, consulte a documentação de referência da API PHP do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Python
Para mais informações, consulte a documentação de referência da API Python do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
Ruby
Para mais informações, consulte a documentação de referência da API Ruby do Cloud Storage.
Para se autenticar no Cloud Storage, configure as Credenciais padrão da aplicação. Para mais informações, consulte o artigo Configure a autenticação para bibliotecas de cliente.
Antes de executar exemplos de código, defina a variável GOOGLE_CLOUD_UNIVERSE_DOMAIN
environment
como s3nsapis.fr
.
APIs REST
API JSON
Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho
Authorization
.Use
cURL
para chamar a API JSON com um pedido deGET
Bucket que inclua o campoautoclass
:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME?fields=autoclass"
Em que
BUCKET_NAME
é o nome do contentor relevante. Por exemplo,my-bucket
.Se o contentor tiver o Autoclass ativado, a resposta é semelhante ao exemplo seguinte:
{ "autoclass": { "enabled": "BOOLEAN", "toggleTime": "DATETIME", "terminalStorageClass": "STORAGE_CLASS", "terminalStorageClassUpdateTime": "DATETIME" }, }
API XML
Não é possível gerir esta funcionalidade através da API XML. Em alternativa, use a consolaTrusted Cloud ou outra ferramenta.
O que se segue?
- Saiba mais sobre a Autoclass.
- Saiba mais sobre a Gestão do ciclo de vida de objetos, que altera automaticamente a classe de armazenamento de um objeto quando cumpre os critérios que especificar.