Configuración de etiquetas para un bucket

Funciones

Esta operación agrega etiquetas a un bucket.

Después de agregar etiquetas a un bucket, todos los registros de detalles de servicio (SDR) generados por las solicitudes para este bucket tendrán las mismas etiquetas. Puede clasificar los SDR para un análisis detallado de costos. Por ejemplo, si una aplicación en ejecución carga datos a un bucket, puede etiquetar el bucket con el nombre de la aplicación. De esta manera, los costes de la aplicación pueden analizarse usando etiquetas en SDR.

Para realizar esta operación, debe tener el permiso PutBucketTagging. De forma predeterminada, solo el propietario del bucket puede eliminar las etiquetas de un bucket. El propietario del bucket puede permitir que otros usuarios realicen esta operación estableciendo una política de bucket o concediéndoles el permiso.

• Un bucket puede tener hasta 10 etiquetas.
• Una clave de etiqueta y un valor de clave pueden contener un máximo de 36 y 43 caracteres, respectivamente.
• Las claves y los valores de etiqueta no pueden contener comas (,), asteriscos (*), barras verticales (|), barras diagonales (/), signos menores que (<), signos mayores que (>), signos iguales (=), barras diagonales inversas (\) o código de carácter de control de ASCII (0x00 a 0x1F). Estas claves y valores de etiqueta deben estar codificados por URL antes de enviarse a un servidor.

Sintaxis de solicitud

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

PUT /?tagging HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com Date: date
Authorization: authorization string
Content-SHA256: SHA256
<Tagging> 
    <TagSet>
        <Tag> 
            <Key>Tag Name</Key> 
            <Value>Tag Value</Value> 
        </Tag> 
    </TagSet> 
</Tagging>

Parámetros de solicitud

Esta solicitud no contiene parámetros de mensaje.

Encabezados de solicitud

Tabla 1 enumera el encabezado de solicitud.

Elementos de solicitud

En esta solicitud, debe configurar las etiquetas de bucket en el cuerpo de la solicitud. La configuración de la etiqueta se carga en formato XML. Tabla 2 describe los elementos de configuración.

Sintaxis de respuesta

1
2
3
4
5

HTTP/1.1 status_code
x-obs-request-id: request id
x-obs-id-2: id
Content-Length: length
Date: date

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta no contiene elementos.

Respuestas de error

Además de los códigos de error comunes, esta API también devuelve otros códigos de error. En la siguiente tabla se enumeran los errores comunes y las posibles causas. Para obtener más información, consulte Tabla 3.

Modelo de solicitud

En este ejemplo se agrega una etiqueta cuya clave es TagKey(Name1) y valor es TagValue(Value1) al bucket examplebucket.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

PUT /?tagging HTTP/1.1
User-Agent: curl/7.29.0
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*
Date: Wed, 27 Jun 2018 13:22:50 GMT
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:Pf1ZyGvVYg2BzOjokZ/BAeR1mEQ=
Content-SHA256: ogX9qClMrVJUBiUSIKDFM0qO41jJM0I5SCN55/OtMyI=
Content-Length: 182

<Tagging xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <TagSet>
    <Tag>
      <Key>TagKey%28Name1%29</Key>
      <Value>TagValue%28Value1%29</Value>
    </Tag>
  </TagSet>
</Tagging>

Modelo de respuesta

1
2
3
4
5

HTTP/1.1 204 No Content
Server: OBS
x-obs-request-id: BF26000001643FEBA09B1ED46932CD07
x-obs-id-2: 32AAAQAAEAABSAAgAAEAABAAAQAAEAABCSEZp87iEirC6DggPB5cN49pSvHBWClg
Date: Wed, 27 Jun 2018 13:22:50 GMT