UpdateConnector - AWS Transfer Family
Sintassi della richiestaParametri della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

UpdateConnector

Aggiorna alcuni parametri per un connettore esistente. Fornisci ConnectorId il connettore che desideri aggiornare, insieme ai nuovi valori per i parametri da aggiornare.

Sintassi della richiesta

{
   "AccessRole": "string",
   "As2Config": { 
      "BasicAuthSecretId": "string",
      "Compression": "string",
      "EncryptionAlgorithm": "string",
      "LocalProfileId": "string",
      "MdnResponse": "string",
      "MdnSigningAlgorithm": "string",
      "MessageSubject": "string",
      "PartnerProfileId": "string",
      "SigningAlgorithm": "string"
   },
   "ConnectorId": "string",
   "LoggingRole": "string",
   "SftpConfig": { 
      "TrustedHostKeys": [ "string" ],
      "UserSecretId": "string"
   },
   "Url": "string"
}

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati nel JSON formato.

AccessRole

I connettori vengono utilizzati per inviare file utilizzando il SFTP protocollo AS2 or. Per il ruolo di accesso, fornisci l'Amazon Resource Name (ARN) del AWS Identity and Access Management ruolo da utilizzare.

Per i AS2 connettori

ConAS2, è possibile inviare file chiamando StartFileTransfer e specificando i percorsi dei file nel parametro di richiesta,SendFilePaths. Utilizziamo la directory principale del file (ad esempio, for--send-file-paths /bucket/dir/file.txt, la directory principale is/bucket/dir/) per archiviare temporaneamente un file di AS2 messaggio elaborato, memorizzare il MDN momento in cui li riceviamo dal partner e scrivere un JSON file finale contenente i metadati pertinenti della trasmissione. Pertanto, AccessRole deve fornire l'accesso in lettura e scrittura alla directory principale della posizione del file utilizzata nella richiesta StartFileTransfer. Inoltre, devi fornire l'accesso in lettura e scrittura alla directory principale dei file che intendi inviare con StartFileTransfer.

Se si utilizza l'autenticazione di base per il AS2 connettore, il ruolo di accesso richiede l'secretsmanager:GetSecretValueautorizzazione per il segreto. Se il segreto viene crittografato utilizzando una chiave gestita dal cliente anziché la chiave AWS gestita in Secrets Manager, il ruolo necessita anche dell'kms:Decryptautorizzazione per quella chiave.

Per i connettori SFTP

Assicurati che il ruolo di accesso fornisca l'accesso in lettura e scrittura alla directory principale della posizione del file utilizzata nella StartFileTransfer richiesta. Inoltre, assicurati che il ruolo fornisca l'secretsmanager:GetSecretValueautorizzazione a AWS Secrets Manager.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.

Modello: arn:.*role/\S+

Campo obbligatorio: no

As2Config

Una struttura che contiene i parametri per un oggetto AS2 connettore.

Tipo: oggetto As2ConnectorConfig

Campo obbligatorio: no

ConnectorId

L'identificatore univoco del connettore.

Tipo: stringa

Vincoli di lunghezza: lunghezza fissa di 19.

Modello: c-([0-9a-f]{17})

Campo obbligatorio: sì

LoggingRole

L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a un connettore di attivare la CloudWatch registrazione per gli eventi Amazon S3. Una volta impostato, puoi visualizzare l'attività del connettore nei tuoi CloudWatch log.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.

Modello: arn:.*role/\S+

Campo obbligatorio: no

SftpConfig

Una struttura che contiene i parametri per un oggetto SFTP connettore.

Tipo: oggetto SftpConnectorConfig

Campo obbligatorio: no

Url

Il punto URL del partner AS2 o dell'SFTPendpoint.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 255.

Campo obbligatorio: no

Sintassi della risposta

{
   "ConnectorId": "string"
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

ConnectorId

Restituisce l'identificatore dell'oggetto connettore che state aggiornando.

Tipo: stringa

Vincoli di lunghezza: lunghezza fissa pari a 19.

Modello: c-([0-9a-f]{17})

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalServiceError

Questa eccezione viene generata quando si verifica un errore nel servizio. AWS Transfer Family

HTTPCodice di stato: 500

InvalidRequestException

Questa eccezione viene generata quando il client invia una richiesta non valida.

HTTPCodice di stato: 400

ResourceExistsException

La risorsa richiesta non esiste o esiste in una regione diversa da quella specificata per il comando.

HTTPCodice di stato: 400

ResourceNotFoundException

Questa eccezione viene generata quando una risorsa non viene trovata dal servizio AWS Transfer Family.

HTTPCodice di stato: 400

ServiceUnavailableException

La richiesta non è riuscita perché il servizio AWS Transfer Family non è disponibile.

HTTPCodice di stato: 500

ThrottlingException

La richiesta è stata negata a causa del throttling della richiesta.

HTTPCodice di stato: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: