Atualizar um arquivo on-line

REMENDO /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}

Atualiza, pausa ou retoma um arquivo online. Esse arquivo armazena dados de um cluster dentro de um projeto. Para usar este recurso, a conta de serviço ou chave de API solicitante deve ter a função de administrador de acesso aos dados do projeto.

Arquivo On-line

parâmetros de caminho

  • groupId string Obrigatório

    Sequência única de 24dígitos hexadecimais que identifica seu projeto. Use o endpoint /groups para extrair todos os projetos aos quais o usuário autenticado tem acesso.

    AVISO: grupos e projetos são termos sinônimos. O ID do seu grupo é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. O recurso e os endpoints correspondentes usam o termo grupos.

    O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

  • archiveId string Obrigatório

    String única de 24 dígitos hexadecimais que identifica o arquivo online que será atualizado.

    O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

  • clusterName string Obrigatório

    Etiqueta legível para humanos que identifica o cluster que contém a collection especificada a partir da qual o aplicativo criou o arquivo online.

    O formato deve corresponder ao seguinte padrão: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.

parâmetros de query

  • envelope booleano

    Sinalizador que indica se o aplicativo empacota a resposta em um objeto JSON 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 consulta. Os endpoints que retornam uma lista de resultados usam o objeto de resultados como um envelope. O aplicativo adiciona o parâmetro de status ao corpo da resposta.

    O valor padrão é false.

  • pretty booleano

    Sinalizador que indica se o corpo da resposta deve estar no formato prettyprint.

    O valor padrão é false.

    Prettyprint
application/vnd.atlas.2023-01-01+json

corpo, corpo Obrigatório

Atualiza, pausa ou retoma um arquivo on-line.

  • critério objeto

    Um dos seguintes:
  • dataExpirationRule objeto

    Regra para especificar quando os dados devem ser excluídos do arquivo.

    Ocultar atributo dataExpirationRule Mostrar atributo dataExpirationRule objeto
    • expireAfterDays integer(int32)

      Número de dias usados nos critérios de data para indicar documentos para exclusão.

      O valor mínimo é 7, o valor máximo é 9215.

  • dataProcessRegion

    Um dos seguintes:
  • pausado booleano

    Sinalizador que indica se este arquivo online existe no estado de pausa. Uma solicitação para retomar falha se a collection tiver outro arquivo online ativo. Para pausar um arquivo online ativo ou retomar um arquivo online pausado, você deve incluir este parâmetro. Para pausar um arquivo ativo, defina para verdadeiro. Para retomar um arquivo em pausa, defina como falso.

  • agendamento objeto

    Um dos seguintes:

Respostas

  • 200 application/vnd.atlas.2023-01-01+json

    OK

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • _id string

      Sequência única de 24dígitos hexadecimais que identifica o arquivo online.

      O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

    • clusterName string

      Etiqueta legível para humanos que identifica o cluster que contém a collection para a qual você deseja criar um arquivo online.

      O formato deve corresponder ao seguinte padrão: ^[a-zA-Z0-9][a-zA-Z0-9-]*$.

    • collName string

      Etiqueta legível para humanos que identifica a collection para a qual você criou o arquivo online.

    • collectionType string

      Classificação da collection de banco de dados MongoDB que você deseja retornar.

      Se você configurar este parâmetro para TIMESERIES, configure "criteria.type" : "date" e "criteria.dateFormat" : "ISODATE".

      Os valores são TIMESERIES ou STANDARD. O valor padrão é STANDARD.

    • critério objeto

      Um dos seguintes:
    • dataExpirationRule objeto

      Regra para especificar quando os dados devem ser excluídos do arquivo.

      Ocultar atributo dataExpirationRule Mostrar atributo dataExpirationRule objeto
      • expireAfterDays integer(int32)

        Número de dias usados nos critérios de data para indicar documentos para exclusão.

        O valor mínimo é 7, o valor máximo é 9215.

    • dataProcessRegion objeto

      Um dos seguintes:
    • dataSetName string

      Etiqueta legível por humanos que identifica o conjunto de dados que o Atlas gera para este arquivo online.

    • dbName string

      Etiqueta legível por humanos do banco de dados que contém a collection que contém o arquivo online.

    • groupId string

      String única de 24dígitos hexadecimais que identifica o projeto que contém o cluster especificado. O cluster especificado contém a collection para a qual criar o arquivo online.

      O formato deve corresponder ao seguinte padrão: ^([a-f0-9]{24})$.

    • partitionFields array[objeto]

      Lista que contém parâmetros de documento a serem usados para dividir de forma lógica os dados em uma coleção. As partições fornecem um nível aproximado de filtragem dos dados de coleta subjacentes. Para dividir seus dados, especifique os parâmetros que você consulta com frequência. Se você especificou ":criteria.type": "DATE" no endpoint CREATE ONE ONLINE ARCHIVE, então pode especificar até três parâmetros para a consulta. Um desses parâmetros deve ser o valor DATE, que é necessário nesse caso. Se você especificou ":criteria.type": "CUSTOM" no endpoint CREATE ONE ONLINE ARCHIVE, poderá especificar até dois parâmetros para a consulta. Consultas que não usam parâmetros ":criteria.type": "DATA" ou ":criteria.type": "CUSTOM" fazem o MongoDB examinar uma coleção completa de todos os documentos arquivados. Isso leva mais tempo e aumenta seus custos.

      Metadados para dividir este arquivo online.

      Pelo menos 1 elemento.

      Ocultar atributos partitionFields Mostrar atributos partitionFields objeto
      • Nome do campo string Obrigatório

        Etiqueta legível por humanos que identifica o parâmetro que o MongoDB Cloud usa para dados de partição. Para especificar um parâmetro aninhado, use a notação de ponto.

        O comprimento máximo é 700.

      • fieldType string

        Tipo de dados do parâmetro que o MongoDB Cloud usa para dados de partição. Os parâmetros de partição do tipo UUID devem ser do subtipo binário 4. O MongoDB Cloud ignora os parâmetros de partição do tipo UUID com subtipo 3.

        Os valores são date, int, long, objectId, string ou uuid.

        UUID
      • order integer(int32) Obrigatório

        Sequência na qual o MongoDB Cloud fatia os dados da collection para criar partições. O recurso expressa essa sequência começando com zero. O valor do parâmetro criteria.dateField é padronizado como o primeiro item na sequência de partição.

        O valor padrão é 0.

    • pausado booleano

      Sinalizador que indica se este arquivo online existe no estado de pausa. Uma solicitação para retomar falha se a collection tiver outro arquivo online ativo. Para pausar um arquivo online ativo ou retomar um arquivo online pausado, você deve incluir este parâmetro. Para pausar um arquivo ativo, defina para verdadeiro. Para retomar um arquivo em pausa, defina como falso.

    • agendamento objeto

      Um dos seguintes:
    • state string

      Fase do processo para criar esse arquivo online quando você faz essa solicitação.

      Estado Indicação
      PENDING O MongoDB Cloud tem documentos em fila para arquivamento. O arquivamento não começou.
      ARCHIVING O MongoDB Cloud começou a arquivar documentos que atendam aos critérios de arquivamento.
      IDLE A MongoDB Cloud aguarda para iniciar o próximo tarefa de arquivamento.
      PAUSING alguém escolheu parar de arquivar. O MongoDB Cloud termina o tarefa de arquivamento em execução e, em seguida, altera o estado para PAUSED quando esse tarefa é concluído.
      PAUSED O MongoDB Cloud interrompeu o arquivamento. Documentos arquivados podem ser consultados. A operação de arquivamento especificada no cluster ativo não pode arquivar documentos adicionais. Você pode retomar o arquivamento de arquivos em pausa a qualquer momento.
      ORPHANED alguém excluiu a coleção associada a um arquivo ativo ou pausado. O MongoDB Cloud não exclui os dados arquivados. Você deve excluir manualmente os arquivos online associados à coleção excluída.
      DELETED alguém excluiu o arquivo foi excluído. Quando alguém exclui um arquivamento online, o MongoDB Cloud remove todos os documentos arquivados associados do armazenamento de objeto na nuvem.

      Os valores são PENDING, ACTIVE, PAUSING, PAUSED, DELETED ou ORPHANED.

  • 400 aplicação/json

    Solicitação inválida.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes da solicitação inválida.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Descreve todas as violações em uma solicitação do cliente .

        Ocultar atributos de campos Mostrar atributos dos campos objeto
        • Descrição string Obrigatório

          Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.

        • Campo string Obrigatório

          Um caminho que leva a um campo no corpo da solicitação.

    • detalhe string

      Descreve as condições ou os motivos específicos que causam cada tipo de erro.

    • Erro integer(int32) Obrigatório

      O código de status HTTP retornado com este erro.

      Documentação externa
    • Código de erro string Obrigatório

      Código de erro do aplicativo retornado com esse erro.

    • Parâmetros array[objeto]

      Parâmetros usados para fornecer mais informações sobre o erro.

    • Razão string

      Mensagens de erro de aplicativo retornadas com este erro.

  • 401 aplicação/json

    Não autorizado.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes da solicitação inválida.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Descreve todas as violações em uma solicitação do cliente .

        Ocultar atributos de campos Mostrar atributos dos campos objeto
        • Descrição string Obrigatório

          Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.

        • Campo string Obrigatório

          Um caminho que leva a um campo no corpo da solicitação.

    • detalhe string

      Descreve as condições ou os motivos específicos que causam cada tipo de erro.

    • Erro integer(int32) Obrigatório

      O código de status HTTP retornado com este erro.

      Documentação externa
    • Código de erro string Obrigatório

      Código de erro do aplicativo retornado com esse erro.

    • Parâmetros array[objeto]

      Parâmetros usados para fornecer mais informações sobre o erro.

    • Razão string

      Mensagens de erro de aplicativo retornadas com este erro.

  • 403 aplicação/json

    Forbidden.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes da solicitação inválida.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Descreve todas as violações em uma solicitação do cliente .

        Ocultar atributos de campos Mostrar atributos dos campos objeto
        • Descrição string Obrigatório

          Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.

        • Campo string Obrigatório

          Um caminho que leva a um campo no corpo da solicitação.

    • detalhe string

      Descreve as condições ou os motivos específicos que causam cada tipo de erro.

    • Erro integer(int32) Obrigatório

      O código de status HTTP retornado com este erro.

      Documentação externa
    • Código de erro string Obrigatório

      Código de erro do aplicativo retornado com esse erro.

    • Parâmetros array[objeto]

      Parâmetros usados para fornecer mais informações sobre o erro.

    • Razão string

      Mensagens de erro de aplicativo retornadas com este erro.

  • 404 aplicação/json

    Não encontrado.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes da solicitação inválida.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Descreve todas as violações em uma solicitação do cliente .

        Ocultar atributos de campos Mostrar atributos dos campos objeto
        • Descrição string Obrigatório

          Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.

        • Campo string Obrigatório

          Um caminho que leva a um campo no corpo da solicitação.

    • detalhe string

      Descreve as condições ou os motivos específicos que causam cada tipo de erro.

    • Erro integer(int32) Obrigatório

      O código de status HTTP retornado com este erro.

      Documentação externa
    • Código de erro string Obrigatório

      Código de erro do aplicativo retornado com esse erro.

    • Parâmetros array[objeto]

      Parâmetros usados para fornecer mais informações sobre o erro.

    • Razão string

      Mensagens de erro de aplicativo retornadas com este erro.

  • 409 aplicação/json

    Conflito.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes da solicitação inválida.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Descreve todas as violações em uma solicitação do cliente .

        Ocultar atributos de campos Mostrar atributos dos campos objeto
        • Descrição string Obrigatório

          Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.

        • Campo string Obrigatório

          Um caminho que leva a um campo no corpo da solicitação.

    • detalhe string

      Descreve as condições ou os motivos específicos que causam cada tipo de erro.

    • Erro integer(int32) Obrigatório

      O código de status HTTP retornado com este erro.

      Documentação externa
    • Código de erro string Obrigatório

      Código de erro do aplicativo retornado com esse erro.

    • Parâmetros array[objeto]

      Parâmetros usados para fornecer mais informações sobre o erro.

    • Razão string

      Mensagens de erro de aplicativo retornadas com este erro.

  • 500 aplicação/json

    Erro interno do servidor.

    Ocultar atributos de resposta Mostrar atributos de resposta objeto
    • badRequestDetail objeto

      Detalhes da solicitação inválida.

      Ocultar atributo ruimRequestDetail Mostrar atributo ruimRequestDetail objeto
      • Campos array[objeto]

        Descreve todas as violações em uma solicitação do cliente .

        Ocultar atributos de campos Mostrar atributos dos campos objeto
        • Descrição string Obrigatório

          Uma descrição do motivo pelo qual o elemento de solicitação é incorreto.

        • Campo string Obrigatório

          Um caminho que leva a um campo no corpo da solicitação.

    • detalhe string

      Descreve as condições ou os motivos específicos que causam cada tipo de erro.

    • Erro integer(int32) Obrigatório

      O código de status HTTP retornado com este erro.

      Documentação externa
    • Código de erro string Obrigatório

      Código de erro do aplicativo retornado com esse erro.

    • Parâmetros array[objeto]

      Parâmetros usados para fornecer mais informações sobre o erro.

    • Razão string

      Mensagens de erro de aplicativo retornadas com este erro.

PATCH /api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}
atlas api onlineArchive updateGroupClusterOnlineArchive --help
import (
	"os"
	"context"
	"log"
	sdk "go.mongodb.org/atlas-sdk/v20231115001/admin"
)

func main() {
	ctx := context.Background()
	clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
	clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")

	// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
	client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))

	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	params = &sdk.UpdateGroupClusterOnlineArchiveApiParams{}
	sdkResp, httpResp, err := client.OnlineArchiveApi.
		UpdateGroupClusterOnlineArchiveWithParams(ctx, params).
		Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/vnd.atlas.2023-11-15+json" \
  --header "Content-Type: application/json" \
  -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}" \
  -d '{ <Payload> }'
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest --include \
  --header "Accept: application/vnd.atlas.2023-11-15+json" \
  --header "Content-Type: application/json" \
  -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/clusters/{clusterName}/onlineArchives/{archiveId}" \
  -d '{ <Payload> }'
Exemplos de solicitação
{
  "criteria": {
    "type": "CUSTOM",
    "query": "string"
  },
  "dataExpirationRule": {
    "expireAfterDays": 42
  },
  "dataProcessRegion": {
    "cloudProvider": "AWS"
  },
  "paused": true,
  "schedule": {
    "type": "DEFAULT"
  }
}
Exemplos de resposta (200)
{
  "_id": "32b6e34b3d91647abb20e7b8",
  "clusterName": "string",
  "collName": "string",
  "collectionType": "STANDARD",
  "criteria": {
    "type": "CUSTOM",
    "query": "string"
  },
  "dataExpirationRule": {
    "expireAfterDays": 42
  },
  "dataProcessRegion": {
    "cloudProvider": "AWS",
    "region": "US_EAST_1"
  },
  "dataSetName": "string",
  "dbName": "string",
  "groupId": "32b6e34b3d91647abb20e7b8",
  "partitionFields": [
    {
      "fieldName": "string",
      "fieldType": "date",
      "order": 0
    }
  ],
  "paused": true,
  "schedule": {
    "type": "DEFAULT"
  },
  "state": "PENDING"
}
Exemplos de resposta (400)
{
  "error": 400,
  "detail": "(This is just an example, the exception may not be related to this endpoint) No provider AWS exists.",
  "reason": "Bad Request",
  "errorCode": "VALIDATION_ERROR"
}
Exemplos de resposta (401)
{
  "error": 401,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Unauthorized",
  "errorCode": "NOT_ORG_GROUP_CREATOR"
}
Exemplos de resposta (403)
{
  "error": 403,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Forbidden",
  "errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
Exemplos de resposta (404)
{
  "error": 404,
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
  "reason": "Not Found",
  "errorCode": "RESOURCE_NOT_FOUND"
}
Exemplos de resposta (409)
{
  "error": 409,
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot delete organization link while there is active migration in following project ids: 60c4fd418ebe251047c50554",
  "reason": "Conflict",
  "errorCode": "CANNOT_DELETE_ORG_ACTIVE_LIVE_MIGRATION_ATLAS_ORG_LINK"
}
Exemplos de resposta (500)
{
  "error": 500,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Internal Server Error",
  "errorCode": "UNEXPECTED_ERROR"
}