Agregación de una etiqueta a un punto de acceso

Puede agregar etiquetas a Puntos de acceso de Amazon S3 y modificar estas etiquetas. No hay ningún cargo adicional por utilizar etiquetas en los puntos de acceso más allá de las tarifas de solicitud estándar de la API de S3. Para obtener más información, consulte Precios de Amazon S3. Para obtener más información sobre el etiquetado de puntos de acceso, consulte Uso de etiquetas con puntos de acceso de S3 para buckets de uso general.

Permisos

Para agregar una etiqueta a un punto de acceso, debe tener el siguiente permiso:

• s3:TagResource

Solución de errores

Si se produce un error al intentar agregar una etiqueta a un punto de acceso, puede hacer lo siguiente:

• Compruebe que tiene los Permisos necesarios para agregar una etiqueta al punto de acceso.

• Si ha intentado agregar una clave de etiqueta que comience con el prefijo reservado de AWS aws:, cámbiela e inténtelo de nuevo.

Pasos

Puede agregar etiquetas a los puntos de acceso mediante la consola de Amazon S3, la interfaz de la línea de comandos (AWS CLI) de AWS, la API de REST de Amazon S3 y los SDK de AWS.

Uso de la consola de S3

Para agregar etiquetas a un punto de acceso mediante la consola de Amazon S3:

1. Inicie sesión en la consola de Amazon S3 en https://console.aws.amazon.com/s3/.

2. En el panel de navegación izquierdo, elija Puntos de acceso (buckets de uso general).

3. Seleccione el nombre del punto de acceso.

4. Elija la pestaña Propiedades.

5. Desplácese hasta la sección Etiquetas y elija Agregar nueva etiqueta.

6. Esto abre la página Agregar etiquetas. Puede ingresar hasta 50 pares de clave valor de etiquetas.

7. Si agrega una nueva etiqueta con el mismo nombre de clave que una etiqueta existente, el valor de la nueva etiqueta invalida el valor de la etiqueta existente.

8. Puede editar también los valores de las etiquetas existentes en esta página.

9. Una vez que haya agregado las etiquetas, elija Guardar cambios.

Uso de los AWS SDK

SDK for Java 2.x

En este ejemplo se muestra cómo agregar etiquetas a un punto de acceso mediante AWS SDK for Java 2.x. Para usar el comando, sustituya los marcadores de posición de entrada del usuario con su propia información.

TagResourceRequest tagResourceRequest = TagResourceRequest.builder().resourceArn(arn:aws::s3:region:111122223333:accesspoint/my-access-point/*)
.accountId(111122223333)
.tags(List.of(Tag.builder().key("key1").value("value1").build(),
Tag.builder().key("key2").value("value2").build()))
.build();
awss3Control.tagResource(tagResourceRequest);

Uso de la API de REST

Para obtener información sobre la compatibilidad de la API de REST de Amazon S3 con la agregación de etiquetas a un punto de acceso, consulte la siguiente sección de la Referencia de la API de Amazon Simple Storage Service:

• TagResource

Uso de AWS CLI

Para instalar la CLI de AWS, consulte Instalación de la CLI de AWS en la Guía del usuario de AWS Command Line Interface.

En el siguiente ejemplo de la CLI se muestra cómo agregar etiquetas a un punto de acceso mediante la AWS CLI. Para usar el comando, sustituya los marcadores de posición de entrada del usuario con su propia información.

Solicitud:

aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3:region:111122223333:accesspoint/my-access-point/* \
--tags "Key=key1,Value=value1"

Respuesta:

{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}