Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
UpdateAgreement
Actualiza algunos de los parámetros de un acuerdo existente. Proporcione los valores AgreementId y ServerId del acuerdo que desee actualizar, junto con los nuevos valores de los parámetros que desee actualizar.
Sintaxis de la solicitud
{
"AccessRole": "string",
"AgreementId": "string",
"BaseDirectory": "string",
"Description": "string",
"LocalProfileId": "string",
"PartnerProfileId": "string",
"ServerId": "string",
"Status": "string"
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- AccessRole
-
Los conectores se utilizan para enviar archivos mediante el protocolo AS2 o SFTP. Para la función de acceso, proporcione el nombre de recurso de Amazon (ARN) de la AWS Identity and Access Management función que se va a utilizar.
Para conectores AS2
Con AS2, puede enviar archivos llamando a
StartFileTransfery especificando las rutas de los archivos en el parámetro de solicitud,SendFilePaths. Utilizamos el directorio principal del archivo (por ejemplo, para--send-file-paths /bucket/dir/file.txt, el directorio principal es/bucket/dir/) para almacenar temporalmente un archivo de mensajes AS2 procesado, almacenar el MDN cuando lo recibimos del socio y escribir un archivo JSON final que contenga los metadatos relevantes de la transmisión. Por lo tanto,AccessRoledebe proporcionar acceso de lectura y escritura al directorio principal de la ubicación del archivo que se utiliza en la solicitudStartFileTransfer. Además, debe proporcionar acceso de lectura y escritura al directorio principal de los archivos que desea enviar conStartFileTransfer.Si utiliza la autenticación básica para el conector AS2, el rol de acceso requiere el permiso
secretsmanager:GetSecretValuepara el secreto. Si el secreto se cifra con una clave gestionada por el cliente en lugar de la clave AWS gestionada en Secrets Manager, el rol también necesitará elkms:Decryptpermiso para esa clave.Para conectores SFTP
Asegúrese de que el acceso al rol proporcione acceso de lectura y escritura al directorio principal de la ubicación del archivo que se utiliza en la solicitud
StartFileTransfer. Además, asegúrese de que el rol otorguesecretsmanager:GetSecretValuepermiso a. AWS Secrets ManagerTipo: cadena
Limitaciones de longitud: longitud mínima de 20. La longitud máxima es de 2048 caracteres.
Patrón:
arn:.*role/\S+Obligatorio: no
- AgreementId
-
Un identificador único para el acuerdo. Este identificador se devuelve al crear un acuerdo.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
a-([0-9a-f]{17})Obligatorio: sí
- BaseDirectory
-
Para cambiar el directorio de destino (carpeta) de los archivos que se transfieren, proporcione la carpeta de bucket que desee usar, por ejemplo,
/DOC-EXAMPLE-BUCKET/home/mydirectory.Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.
Patrón:
(|/.*)Obligatorio: no
- Description
-
Para reemplazar la descripción existente, proporcione una descripción breve del acuerdo.
Tipo: string
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.
Patrón:
[\p{Graph}]+Obligatorio: no
- LocalProfileId
-
Un identificador único para el perfil local de AS2.
Para cambiar el identificador del perfil local, introduzca aquí un nuevo valor.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
p-([0-9a-f]{17})Obligatorio: no
- PartnerProfileId
-
Un identificador único para el perfil de socio. Para cambiar el identificador del perfil del socio, introduzca aquí un nuevo valor.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
p-([0-9a-f]{17})Obligatorio: no
- ServerId
-
Identificador único asignado por el sistema para una instancia del servidor. Este identificador indica el servidor específico que utiliza el acuerdo.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
s-([0-9a-f]{17})Obligatorio: sí
- Status
-
Puede actualizar el estado del acuerdo, ya sea activando un acuerdo inactivo o al revés.
Tipo: cadena
Valores válidos:
ACTIVE | INACTIVEObligatorio: no
Sintaxis de la respuesta
{
"AgreementId": "string"
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- AgreementId
-
Un identificador único para el acuerdo. Este identificador se devuelve al crear un acuerdo.
Tipo: cadena
Limitaciones de longitud: longitud fija de 19.
Patrón:
a-([0-9a-f]{17})
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- InternalServiceError
-
Esta excepción se produce cuando se produce un error en el AWS Transfer Family servicio.
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.
Código de estado HTTP: 400
- ResourceExistsException
-
El recurso solicitado no existe o existe en una región distinta de la especificada para el comando.
Código de estado HTTP: 400
- ResourceNotFoundException
-
Esta excepción se produce cuando el servicio AWS Transfer Family no encuentra un recurso.
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud ha fallado porque el servicio AWS Transfer Family no está disponible.
Código de estado HTTP: 500
- ThrottlingException
-
La solicitud fue denegada debido a una limitación de la solicitud.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente:
