Atualiza a configuração do armazenamento de oplog3 de um s.
URL base: https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup
Resource
PUT /oplog/s3Configs/{S3-OPLOG-CONFIG-ID}
Parâmetros do caminho da solicitação
Nome | Tipo | Descrição |
|---|---|---|
S3-OPLOG-CONFIG-ID | string | O identificador exclusivo que representa essa configuração oplog S3. |
Solicitar parâmetros de query
Os seguintes parâmetros de query são opcionais:
Nome | Tipo | necessidade | Descrição | Default |
|---|---|---|---|---|
pretty | booleano | Opcional | Sinalizador que indica se o corpo da resposta está em um formato pretty-print. |
|
envelope | booleano | Opcional | Sinalizador que indica se deve envolver a resposta em um envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query. Para endpoints que retornam um resultado, o corpo da resposta inclui:
|
|
Parâmetros do corpo da solicitação
Nome | Tipo | necessidade | Descrição | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
acceptTos | booleano | Obrigatório | Sinalizador que indica se você aceitou os termos de serviço para usar armazenamentos de armazenamento compatíveis com S3com o Ops Manager. Você deve definir isso como Se você definir isso como | |||||||||
assignEnabled | booleano | Opcional | Sinalizador que indica se você pode atribuir tarefas de backup a esse armazenamento de dados. | |||||||||
Chave de acesso AWS | string | Condicional | ID da chave de acesso da Amazon Web Services que pode acessar o bucket de armazenamento compatível com o S3 especificado em s3BucketName. Se | |||||||||
Chave secreta AWS | string | Condicional | Chave de acesso secreto Amazon Web Services que pode acessar o bucket de armazenamento compatível com S3s especificado no Se | |||||||||
customCertificates | array | Opcional | Lista de certificados de autoridade de certificação válidos que se aplicam ao bucket de armazenamento associado compatível com S3. | |||||||||
customCertificates[n].filename | string | Opcional | Nome que identifica o arquivo PEM da Autoridade de certificação. | |||||||||
customCertificates[n].certString | string | Opcional | Conteúdo do arquivo PEM da autoridade de certificação que compõem sua cadeia de autoridade de certificação. | |||||||||
disableProxyS3 | booleano | Opcional | Sinalizador que indica se o proxy HTTP deve ser usado ao3conectar-se ao armazenamento compatível com S. Você não precisa definir esse valor, a menos que tenha configurado o Ops Manager para usar o proxy HTTP. | |||||||||
Credenciais criptografadas | booleano | Opcional | Sinalizador que indica se o nome de usuário e a senha deste armazenamento de oplog de armazenamento compatível com S3foram criptografados usando a ferramenta de credenciais. | |||||||||
rótulos | array de strings | Opcional | Array de marcações para gerenciar quais tarefas de backup o MongoDB Ops Manager pode atribuir a quais armazenamentos de oplog S3. A definição dessas marcações limita as tarefas de backup que esse armazenamento de oplog compatível com S3pode processar. Se omitido, esse armazenamento de oplog compatível com S3só pode processar tarefas de backup para projetos que não usam rótulos para filtrar suas tarefas. | |||||||||
OIDC | objeto | Opcional | Opcional. Configuraçõesde autenticação OIDC para este armazenamento. O
Os métodos Quando Para mudar um armazenamento do OIDC para outro mecanismo de autenticação, envie Se você atualizar esse armazenamento e omitir o
| |||||||||
pathStyleAccessEnabled | booleano | Obrigatório | Sinalizador que indica o estilo deste endpoint.
Para revisar as convenções de URL do contêiner de armazenamento compatível com S3, consulte a documentação do Amazon Web Services S3. | |||||||||
s3AuthMethod | string | Opcional | Método usado para autorizar o acesso ao bucket de armazenamento compatível com o S3 especificado em s3BucketName. O Ops Manager aceita os seguintes valores:
| |||||||||
s3BucketEndpoint | string | Obrigatório | URL usada para acessar esse bucket de armazenamento compatível com S3. | |||||||||
Nome do bucket do S3 | string | Obrigatório | Nome do bucket de armazenamento compatível com S3que hospeda o armazenamento de oplog de armazenamento compatível com S3 . | |||||||||
Conexões máx. S3 | número | Obrigatório | Inteiro positivo que indica o número máximo de conexões a este armazenamento de oplog de armazenamento compatível com S3 . | |||||||||
s3RegionOverride | string | Condicional | Região onde reside seu contêiner de armazenamento compatível com S3. Use esse campo somente se o s3BucketEndpoint do seu armazenamento de armazenamento compatível com S3 não for compatível com o escopo de região. Não use este campo com Amazon Web Services S3. | |||||||||
sseEnabled | booleano | Obrigatório | Sinalizador que indica se esse armazenamento3de oplog de armazenamento compatível com S permite a criptografia do lado do servidor. | |||||||||
uri | string | Obrigatório | Lista separada por vírgulas de hosts no formato | |||||||||
ssl | booleano | Opcional | Sinalizador que indica se este armazenamento de oplog de armazenamento compatível com S3só aceita conexões criptografadas usando TLS. | |||||||||
writeConcern | string | Opcional | Write concern usado para este armazenamento de oplog. O Ops Manager aceita os seguintes valores:
Para saber mais sobre os níveis de reconhecimento de escrita no MongoDB, consulte Write Concern. |
Resposta
Nome | Tipo | Descrição | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
acceptTos | booleano | Sinalizador que indica se você aceitou os termos de serviço para usar armazenamentos de armazenamento compatíveis com S3com o Ops Manager. Você deve definir isso como | |||||||||
assignEnabled | booleano | Sinalizador que indica se você pode atribuir tarefas de backup a esse armazenamento de dados. | |||||||||
Chave de acesso AWS | string | ID da chave de acesso da Amazon Web Services que pode acessar o bucket de armazenamento compatível com o S3 especificado em s3BucketName. | |||||||||
Chave secreta AWS | string | Chave de acesso secreto da Amazon Web Services que pode acessar o bucket de armazenamento compatível com o S3 especificado em s3BucketName. | |||||||||
customCertificates | array | Lista de certificados de autoridade de certificação válidos que se aplicam ao bucket de armazenamento associado compatível com S3. | |||||||||
customCertificates[n].filename | string | Nome que identifica o arquivo PEM da Autoridade de certificação. | |||||||||
customCertificates[n].certString | string | Conteúdo do arquivo PEM da autoridade de certificação que compõem sua cadeia de autoridade de certificação. | |||||||||
disableProxyS3 | booleano | Sinalizador que indica se o proxy HTTP deve ser usado ao conectar-se ao3armazenamento compatível com S. | |||||||||
Credenciais criptografadas | booleano | Sinalizador que indica se o nome de usuário e a senha deste armazenamento de oplog de armazenamento compatível com S3foram criptografados usando a ferramenta de credenciais. | |||||||||
id | string | Nome que identifica exclusivamente este armazenamento de oplog de armazenamento compatível com S3 . | |||||||||
rótulos | array de strings | Array de marcações para gerenciar quais tarefas de backup o MongoDB Ops Manager pode atribuir a quais armazenamentos de oplog compatíveis com S3. | |||||||||
links | array de objetos | Um ou mais links para sub-recursos ou recursos relacionados. Todas as arrays | |||||||||
OIDC | objeto | Configuraçõesde autenticação OIDC para este armazenamento. O
| |||||||||
pathStyleAccessEnabled | booleano | Sinalizador que indica o estilo deste endpoint.
Para revisar as convenções de URL do contêiner de armazenamento compatível com S3, consulte a documentação do Amazon Web Services S3. | |||||||||
s3BucketEndpoint | string | URL que o Ops Manager usa para acessar esse bucket de armazenamento compatível com S3. | |||||||||
Nome do bucket do S3 | string | Nome do bucket de armazenamento compatível com S3que hospeda o armazenamento de oplog de armazenamento compatível com S3 . | |||||||||
s3RegionOverride | string | Região onde reside seu contêiner de armazenamento compatível com S3. Esse campo se aplica somente se o s3BucketEndpoint do seu armazenamento de armazenamento compatível com S3 não suportar o escopo de região. MongoDB Ops Manager retorna esse campo somente se você o tiver incluído ao criar ou atualizar esse armazenamento de oplog de armazenamento compatível com S3. | |||||||||
sseEnabled | booleano | Sinalizador que indica se este armazenamento3de oplog de armazenamento compatível com S habilita a criptografia do lado do servidor. | |||||||||
ssl | booleano | Sinalizador que indica se este armazenamento de oplog de armazenamento compatível com S3só aceita conexões criptografadas usando TLS. | |||||||||
uri | string | Connection string que se conecta ao banco de dados de metadados desse armazenamento de oplog de armazenamento compatível com S3. Esse banco de dados armazena as localizações dos blocos no bucket de armazenamento compatível com S3 . | |||||||||
writeConcern | string | Write concern usado para este armazenamento de oplog. O Ops Manager retorna um dos seguintes valores:
Para saber mais sobre os níveis de reconhecimento de escrita no MongoDB, consulte Write Concern. |
Exemplo de solicitação
curl --user '{PUBLIC-KEY}:{PRIVATE-KEY}' --digest \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --include \ --request PUT 'https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/oplog/s3Configs/{S3-OPLOG-CONFIG-ID}?pretty=true' \ --data '{ "assignmentEnabled": true, "awsAccessKey": "access", "awsSecretKey": "secret", "encryptedCredentials": false, "labels": [ "l1", "l2" ], "s3BucketEndpoint": "http://backup.example.com/oplog", "s3BucketName": "oplog", "uri": "mongodb://localhost:27017", "ssl": true, "writeConcern": "W2" }'
Exemplo de resposta
Cabeçalho de resposta
401 Unauthorized Content-Type: application/json;charset=ISO-8859-1 Date: {dateInUnixFormat} WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false Content-Length: {requestLengthInBytes} Connection: keep-alive
200 OK Vary: Accept-Encoding Content-Type: application/json Strict-Transport-Security: max-age=300 Date: {dateInUnixFormat} Connection: keep-alive Content-Length: {requestLengthInBytes} X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
Corpo de resposta
{ "assignmentEnabled": true, "awsAccessKey": "access", "awsSecretKey": "secret", "encryptedCredentials": false, "id": "id", "labels": [ "l1", "l2" ], "links": [ { "href": "https://{OPSMANAGER-HOST}:{PORT}/api/public/v1.0/admin/backup/oplog/s3Configs/{S3-OPLOG-CONFIG-ID}", "rel": "self" } ], "s3BucketEndpoint": "http://backup.example.com/oplog", "s3BucketName": "oplog", "uri": "mongodb://localhost:27017", "ssl": true, "writeConcern": "W2" }