Esta página descreve como alterar a classe de armazenamento de objetos num contentor através da reescrita do objeto.
- Para saber como alterar as classes de armazenamento de objetos sem reescrever um objeto, consulte a funcionalidade de gestão do ciclo de vida de objetos.
- Para saber como o Cloud Storage pode gerir automaticamente as classes de armazenamento dos seus objetos, consulte a funcionalidade Autoclass.
Funções necessárias
Para receber as autorizações necessárias para alterar a classe de armazenamento de um objeto através da reescrita do objeto, peça ao administrador para lhe conceder a função de utilizador do objeto de armazenamento (roles/storage.objectUser
) no contentor.
Esta função contém as autorizações necessárias para alterar a classe de armazenamento de um objeto. Para ver as autorizações exatas necessárias, expanda a secção Autorizações necessárias:
Autorizações necessárias
storage.objects.create
storage.objects.delete
storage.objects.get
storage.objects.list
Também pode conseguir estas autorizações com outras funções predefinidas ou funções personalizadas.
Para ver instruções sobre como conceder funções em contentores, consulte o artigo Defina e faça a gestão de políticas de IAM em contentores.
Altere a classe de armazenamento de um objeto
Conclua os passos seguintes para alterar a classe de armazenamento de um objeto:
Consola
Não é possível definir classes de armazenamento de objetos individuais através da Google Cloud consola. Em alternativa, use a Google Cloud CLI.
Linha de comandos
Use o comando gcloud storage objects update
com a flag --storage-class
. Por exemplo:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME --storage-class=STORAGE_CLASS
Onde:
BUCKET_NAME
é o nome do contentor que contém o objeto cuja classe quer alterar. Por exemplo,my-bucket
.OBJECT_NAME
é o nome do objeto cuja classe quer alterar. Por exemplo,pets/dog.png
.STORAGE_CLASS
é a nova classe de armazenamento para o seu objeto. Por exemplo,nearline
.
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.
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.
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.
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.
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.
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.
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.
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.
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": "STORAGE_CLASS" }
Onde:
STORAGE_CLASS
é a nova classe de armazenamento para o seu objeto. Por exemplo,nearline
.
Use
cURL
para chamar a API JSON com umPOST
objeto, pedido:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage./storage/v1/b/BUCKET_NAME/o/OBJECT_NAME/rewriteTo/b/BUCKET_NAME/o/OBJECT_NAME"
Onde:
JSON_FILE_NAME
é o caminho para o ficheiro JSON que criou no passo 2.BUCKET_NAME
é o nome do contentor que contém o objeto original. Por exemplo,my-bucket
.OBJECT_NAME
é o nome codificado por URL do objeto. Por exemplo,pets/dog.png
, codificado por URL comopets%2Fdog.png
.
API XML
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 XML com um pedido dePUT
objeto:curl -X PUT --data-binary @OBJECT \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: OBJECT_CONTENT_TYPE" \ -H "x-goog-storage-class: STORAGE_CLASS" \ "https://storage./BUCKET_NAME/OBJECT_NAME"
Onde:
OBJECT
é o caminho local para o objeto cuja classe de armazenamento quer alterar (tem de voltar a carregar o objeto quando alterar a classe de armazenamento com a API XML). Por exemplo,Desktop/dog.png
.OBJECT_CONTENT_TYPE
é o tipo de conteúdo do objeto. Por exemplo,image/png
.STORAGE_CLASS
é a nova classe de armazenamento para o seu objeto. Por exemplo,nearline
.BUCKET_NAME
é o nome do contentor que contém o objeto que está a reescrever. Por exemplo,my-bucket
.OBJECT_NAME
é o nome com codificação URL do objeto que está a reescrever. Por exemplo,pets/dog.png
, URL codificado comopets%2Fdog.png
.
O que se segue?
- Saiba mais sobre as classes de armazenamento disponíveis.
- Altere as classes de armazenamento de objetos com a gestão do ciclo de vida de objetos.
- Explore outras funcionalidades do ciclo de vida dos dados do Cloud Storage.
- Saiba mais sobre os metadados de objetos.
- Saiba como usar as condições prévias do pedido para evitar condições de concorrência.