Copyright | (c) 2013-2021 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Changes information about the current Account resource.
Synopsis
- data UpdateAccount = UpdateAccount' {}
- newUpdateAccount :: UpdateAccount
- updateAccount_patchOperations :: Lens' UpdateAccount (Maybe [PatchOperation])
- data Account = Account' {}
- newAccount :: Account
- account_apiKeyVersion :: Lens' Account (Maybe Text)
- account_cloudwatchRoleArn :: Lens' Account (Maybe Text)
- account_features :: Lens' Account (Maybe [Text])
- account_throttleSettings :: Lens' Account (Maybe ThrottleSettings)
Creating a Request
data UpdateAccount Source #
Requests API Gateway to change information about the current Account resource.
See: newUpdateAccount
smart constructor.
UpdateAccount' | |
|
Instances
newUpdateAccount :: UpdateAccount Source #
Create a value of UpdateAccount
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:patchOperations:UpdateAccount'
, updateAccount_patchOperations
- A list of update operations to be applied to the specified resource and
in the order specified in this list.
Request Lenses
updateAccount_patchOperations :: Lens' UpdateAccount (Maybe [PatchOperation]) Source #
A list of update operations to be applied to the specified resource and in the order specified in this list.
Destructuring the Response
Represents an AWS account that is associated with API Gateway.
To view the account info, call GET
on this resource.
Error Codes
The following exception may be thrown when the request fails.
- UnauthorizedException
- NotFoundException
- TooManyRequestsException
For detailed error code information, including the corresponding HTTP Status Codes, see API Gateway Error Codes
Example: Get the information about an account.
Request
GET /account HTTP/1.1 Content-Type: application/json Host: apigateway.us-east-1.amazonaws.com X-Amz-Date: 20160531T184618Z Authorization: AWS4-HMAC-SHA256 Credential={access_key_ID}/us-east-1/apigateway/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature={sig4_hash}
Response
The successful response returns a 200 OK
status code and a payload
similar to the following:
{ "_links": { "curies": { "href": "https://docs.aws.amazon.com/apigateway/latest/developerguide/account-apigateway-{rel}.html", "name": "account", "templated": true }, "self": { "href": "/account" }, "account:update": { "href": "/account" } }, "cloudwatchRoleArn": "arn:aws:iam::123456789012:role/apigAwsProxyRole", "throttleSettings": { "rateLimit": 500, "burstLimit": 1000 } }
In addition to making the REST API call directly, you can use the AWS CLI and an AWS SDK to access this resource.
API Gateway Limits Developer Guide, AWS CLI
See: newAccount
smart constructor.
Account' | |
|
Instances
newAccount :: Account Source #
Create a value of Account
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:apiKeyVersion:Account'
, account_apiKeyVersion
- The version of the API keys used for the account.
$sel:cloudwatchRoleArn:Account'
, account_cloudwatchRoleArn
- The ARN of an Amazon CloudWatch role for the current Account.
$sel:features:Account'
, account_features
- A list of features supported for the account. When usage plans are
enabled, the features list will include an entry of "UsagePlans"
.
$sel:throttleSettings:Account'
, account_throttleSettings
- Specifies the API request limits configured for the current Account.
Response Lenses
account_apiKeyVersion :: Lens' Account (Maybe Text) Source #
The version of the API keys used for the account.
account_cloudwatchRoleArn :: Lens' Account (Maybe Text) Source #
The ARN of an Amazon CloudWatch role for the current Account.
account_features :: Lens' Account (Maybe [Text]) Source #
A list of features supported for the account. When usage plans are
enabled, the features list will include an entry of "UsagePlans"
.
account_throttleSettings :: Lens' Account (Maybe ThrottleSettings) Source #
Specifies the API request limits configured for the current Account.