put-bucket-replication

Описание

Создает конфигурацию репликации или заменяет существующую. Для получения дополнительной информации, см. Репликация в руководстве пользователя Amazon S3.

Укажите конфигурацию репликации в теле запроса. В конфигурации репликации вы указываете имя целевого ведра или ведер, где Amazon S3 должен реплицировать объекты, роль IAM, которую Amazon S3 может принять, чтобы реплицировать объекты от вашего имени, и другую соответствующую информацию. Вы можете вызвать этот запрос для конкретного региона Amazon Web Services, используя ключевое условие ` aws:RequestedRegion https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requestedregion`__.

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

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

Сведения об включении версии ведра см. в разделе Использование версиирования.

По умолчанию Amazon S3 не реплицирует объекты, хранящиеся в режиме покоя с использованием шифрования на стороне сервера с ключами KMS. Чтобы реплицировать объекты, зашифрованные с помощью KMS Amazon Web Services, добавьте следующее: SourceSelectionCriteria , SseKmsEncryptedObjects , Status , EncryptionConfiguration , и ReplicaKmsKeyID . Сведения о конфигурации репликации см. в разделе Репликация объектов, созданных с помощью SSE с использованием ключей KMS.

Для получения информации об ошибках PutBucketReplication, см. Список кодов ошибок, связанных с репликацией.

Чтобы создать запрос PutBucketReplication, у вас должны быть s3:PutReplicationConfiguration разрешения для ведра.

По умолчанию владелец ресурса, в данном случае учетная запись Amazon Web Services, которая создала ведро, может выполнить эту операцию. Владелец ресурса также может предоставить другим разрешения на выполнение операции. Дополнительную информацию о разрешениях см. в разделах Указание разрешений в политике и Управление разрешениями доступа к вашим ресурсам Amazon S3.

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

• GetBucketReplication
• DeleteBucketReplication

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

Синопсис

  put-bucket-replication
--bucket <value>
[--content-md5 <value>]
[--checksum-algorithm <value>]
--replication-configuration <value>
[--token <value>]
[--expected-bucket-owner <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]

Параметры

--bucket (строка)

--content-md5 (строка)

--checksum-algorithm (строка)

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

--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
• таблица
• yaml
• yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

• включено
• выключено
• автоматически

--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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

• base64
• raw-in-base64-out

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

Отключить кли-пейджер для вывода.

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

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

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

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

Примеры

Настройка репликации для корзины S3

Следующий put-bucket-replication пример применяет конфигурацию репликации к указанной корзине S3.

aws s3api put-bucket-replication \
    --bucket amzn-s3-demo-bucket1 \
    --replication-configuration file://replication.json

Содержание replication.json:

{
    "Role": "arn:aws:iam::123456789012:role/s3-replication-role",
    "Rules": [
        {
            "Status": "Enabled",
            "Priority": 1,
            "DeleteMarkerReplication": { "Status": "Disabled" },
            "Filter" : { "Prefix": ""},
            "Destination": {
                "Bucket": "arn:aws:s3:::amzn-s3-demo-bucket2"
            }
        }
    ]
}

Корзина назначения должна иметь включенную версионирование. Указанная роль должна иметь разрешение на запись в корзину назначения и иметь отношения доверия, которые разрешают Amazon S3 принять на себя роль.

Пример политики разрешений роли:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket1"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetObjectVersion",
                "s3:GetObjectVersionAcl",
                "s3:GetObjectVersionTagging"
            ],
            "Resource": [
                "arn:aws:s3:::amzn-s3-demo-bucket1/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:ReplicateObject",
                "s3:ReplicateDelete",
                "s3:ReplicateTags"
            ],
            "Resource": "arn:aws:s3:::amzn-s3-demo-bucket2/*"
        }
    ]
}

Пример политики отношений доверия:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "s3.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

Эта команда не выводит ничего.

Для получения дополнительной информации обратитесь к этой теме в Руководстве пользователя Amazon Simple Storage Service Console.

Вывод

Нет