put-bucket-replication

Описание

Создаёт конфигурацию репликации или заменяет существующую. Сведения о конфигурации репликации S3 на Outposts см. в разделе Репликация объектов для S3 на Outposts в Руководстве пользователя Amazon S3.

Укажите конфигурацию репликации в теле запроса. В конфигурации репликации вы предоставляете следующую информацию:

• Имя целевого ведра или ведёр, в которые вы хотите, чтобы S3 на Outposts реплицировал объекты
• Роль Identity and Access Management (IAM), которую S3 на Outposts может принять, чтобы реплицировать объекты от вашего имени
• Другая релевантная информация, такая как правила репликации

Конфигурация репликации должна включать хотя бы одно правило и может содержать максимум 100. Каждое правило определяет подмножество объектов для репликации, фильтруя объекты в исходном ведре Outposts. Чтобы выбрать дополнительные подмножества объектов для репликации, добавьте правило для каждого подмножества.

Чтобы указать подмножество объектов в исходном ведре Outposts, к которому применяется правило репликации, добавьте элемент Filter в качестве потомка элемента Rule. Вы можете фильтровать объекты по префиксу ключа объекта, одному или нескольким тегам объекта или тому и другому. Когда вы добавляете элемент Filter в конфигурацию, вы также должны добавить следующие элементы: DeleteMarkerReplication , Status и Priority.

Использование PutBucketReplication на Outposts требует, чтобы в обоих ведрах (источнике и назначении) была включена версия. Сведения о включении версионирования в ведро см. в разделе Управление версионированием S3 для ведра S3 на Outposts.

Сведения о причинах сбоев репликации S3 на Outposts см. в разделе Причины сбоев репликации в Руководстве пользователя Amazon S3.

Ведра Outposts зашифрованы в любое время. Все объекты в исходном ведре Outposts зашифрованы и могут быть реплицированы. Кроме того, все копии в целевом ведре Outposts шифруются с тем же ключом шифрования, что и объекты в исходном ведре Outposts.

Чтобы создать запрос PutBucketReplication, вы должны иметь разрешения s3-outposts:PutReplicationConfiguration для ведра. Владелец ведра Outposts имеет это разрешение по умолчанию и может предоставить его другим. Дополнительные сведения о разрешениях см. в разделе Настройка IAM с S3 на Outposts и Управление доступом к ведрам S3 на Outposts.

Все запросы Amazon S3 на Outposts REST API для этого действия требуют дополнительного параметра x-amz-outpost-id, который должен быть передан вместе с запросом. Кроме того, вы должны использовать префикс имени хоста конечной точки S3 на Outposts вместо s3-control. Пример синтаксиса запроса для Amazon S3 на Outposts, который использует префикс имени хоста конечной точки S3 на Outposts и x-amz-outpost-id, полученный с помощью ARN точки доступа, см. в разделе Примеры.

Следующие операции связаны с PutBucketReplication:

• GetBucketReplication
• DeleteBucketReplication

См. также: Документация по API AWS

Краткое описание

  put-bucket-replication
--account-id <value>
--bucket <value>
--replication-configuration <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--account-id (строка)

--bucket (строка)

--replication-configuration (структура)

{
  "Role": "string",
  "Rules": [
    {
      "ID": "string",
      "Priority": integer,
      "Prefix": "string",
      "Filter": {
        "Prefix": "string",
        "Tag": {
          "Key": "string",
          "Value": "string"
        },
        "And": {
          "Prefix": "string",
          "Tags": [
            {
              "Key": "string",
              "Value": "string"
            }
            ...
          ]
        }
      },
      "Status": "Enabled"|"Disabled",
      "SourceSelectionCriteria": {
        "SseKmsEncryptedObjects": {
          "Status": "Enabled"|"Disabled"
        },
        "ReplicaModifications": {
          "Status": "Enabled"|"Disabled"
        }
      },
      "ExistingObjectReplication": {
        "Status": "Enabled"|"Disabled"
      },
      "Destination": {
        "Account": "string",
        "Bucket": "string",
        "ReplicationTime": {
          "Status": "Enabled"|"Disabled",
          "Time": {
            "Minutes": integer
          }
        },
        "AccessControlTranslation": {
          "Owner": "Destination"
        },
        "EncryptionConfiguration": {
          "ReplicaKmsKeyID": "string"
        },
        "Metrics": {
          "Status": "Enabled"|"Disabled",
          "EventThreshold": {
            "Minutes": integer
          }
        },
        "StorageClass": "STANDARD"|"REDUCED_REDUNDANCY"|"STANDARD_IA"|"ONEZONE_IA"|"INTELLIGENT_TIERING"|"GLACIER"|"DEEP_ARCHIVE"|"OUTPOSTS"|"GLACIER_IR"
      },
      "DeleteMarkerReplication": {
        "Status": "Enabled"|"Disabled"
      },
      "Bucket": "string"
    }
    ...
  ]
}

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного JSON, так как строка будет воспринята буквально. Это может быть не указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или значение input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, оно выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно валидирует входные данные командной строки и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включает отладку ведения журнала.

--endpoint-url (строка)

Переопределяет стандартный URL команды указанным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого подключения SSL AWS CLI проверяет сертификаты SSL. Этот параметр переопределяет стандартное поведение проверки сертификатов SSL.

--no-paginate (логическое значение)

Отключает автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

Запрос JMESPath для использования при фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет параметры конфигурации/среды.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включение/выключение цветного вывода.

• on
• off
• auto

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл с набором сертификатов CA для использования при проверке сертификатов SSL. Переопределяет параметры конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и тайм-аута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться без блокировки и тайм-аута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого файла, соответствующего двоичному блоку, fileb:// всегда будет рассматриваться как двоичное и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

--no-cli-pager (логическое значение)

Отключение пагинации cli для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключение автоматической запроса параметров ввода CLI.

Вывод

Нет