Controllare l'accesso alla documentazione dell'API

Se hai un team dedicato alla documentazione per scrivere e modificare la documentazione dell'API, puoi configurare autorizzazioni di accesso separate per i tuoi sviluppatori (per lo sviluppo dell'API) e per i tuoi scrittori o editori (per lo sviluppo del contenuto). Questo è particolarmente appropriato quando un fornitore di terze parti è coinvolto nella creazione della documentazione.

Per consentire al team della documentazione l'accesso per creare, aggiornare e pubblicare la documentazione dell'API, puoi assegnare al team della documentazione un ruolo IAM con la seguente policy IAM, dove account_id è l'ID dell'account AWS del team della documentazione.

{
  "Version": "2012-10-17",
  "Statement": [

    {
      "Sid": "StmtDocPartsAddEditViewDelete",
      "Effect": "Allow",
      "Action": [
        "apigateway:GET",
        "apigateway:PUT",
        "apigateway:POST",
        "apigateway:PATCH",
        "apigateway:DELETE"
      ],
      "Resource": [
        "arn:aws:apigateway::account_id:/restapis/*/documentation/*"
      ]
    }
  ]
}

Per informazioni sull'impostazione delle autorizzazioni per accedere alle risorse di API Gateway, consultare Come funziona Amazon API Gateway con IAM.