@Generated(value="software.amazon.awssdk:codegen") public interface Cloud9Client extends SdkClient
builder() method.
AWS Cloud9 is a collection of tools that you can use to code, build, run, test, debug, and release software in the cloud.
For more information about AWS Cloud9, see the AWS Cloud9 User Guide.
AWS Cloud9 supports these operations:
CreateEnvironmentEC2: Creates an AWS Cloud9 development environment, launches an Amazon EC2 instance,
and then connects from the instance to the environment.
CreateEnvironmentMembership: Adds an environment member to an environment.
DeleteEnvironment: Deletes an environment. If an Amazon EC2 instance is connected to the environment,
also terminates the instance.
DeleteEnvironmentMembership: Deletes an environment member from an environment.
DescribeEnvironmentMemberships: Gets information about environment members for an environment.
DescribeEnvironments: Gets information about environments.
DescribeEnvironmentStatus: Gets status information for an environment.
ListEnvironments: Gets a list of environment identifiers.
UpdateEnvironment: Changes the settings of an existing environment.
UpdateEnvironmentMembership: Changes the settings of an existing environment member for an environment.
| Modifier and Type | Field and Description |
|---|---|
static String |
SERVICE_NAME |
| Modifier and Type | Method and Description |
|---|---|
static Cloud9ClientBuilder |
builder()
Create a builder that can be used to configure and create a
Cloud9Client. |
static Cloud9Client |
create()
Create a
Cloud9Client with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider. |
default CreateEnvironmentEc2Response |
createEnvironmentEC2(Consumer<CreateEnvironmentEc2Request.Builder> createEnvironmentEc2Request)
Creates an AWS Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance,
and then connects from the instance to the environment.
|
default CreateEnvironmentEc2Response |
createEnvironmentEC2(CreateEnvironmentEc2Request createEnvironmentEc2Request)
Creates an AWS Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance,
and then connects from the instance to the environment.
|
default CreateEnvironmentMembershipResponse |
createEnvironmentMembership(Consumer<CreateEnvironmentMembershipRequest.Builder> createEnvironmentMembershipRequest)
Adds an environment member to an AWS Cloud9 development environment.
|
default CreateEnvironmentMembershipResponse |
createEnvironmentMembership(CreateEnvironmentMembershipRequest createEnvironmentMembershipRequest)
Adds an environment member to an AWS Cloud9 development environment.
|
default DeleteEnvironmentResponse |
deleteEnvironment(Consumer<DeleteEnvironmentRequest.Builder> deleteEnvironmentRequest)
Deletes an AWS Cloud9 development environment.
|
default DeleteEnvironmentResponse |
deleteEnvironment(DeleteEnvironmentRequest deleteEnvironmentRequest)
Deletes an AWS Cloud9 development environment.
|
default DeleteEnvironmentMembershipResponse |
deleteEnvironmentMembership(Consumer<DeleteEnvironmentMembershipRequest.Builder> deleteEnvironmentMembershipRequest)
Deletes an environment member from an AWS Cloud9 development environment.
|
default DeleteEnvironmentMembershipResponse |
deleteEnvironmentMembership(DeleteEnvironmentMembershipRequest deleteEnvironmentMembershipRequest)
Deletes an environment member from an AWS Cloud9 development environment.
|
default DescribeEnvironmentMembershipsResponse |
describeEnvironmentMemberships()
Gets information about environment members for an AWS Cloud9 development environment.
|
default DescribeEnvironmentMembershipsResponse |
describeEnvironmentMemberships(Consumer<DescribeEnvironmentMembershipsRequest.Builder> describeEnvironmentMembershipsRequest)
Gets information about environment members for an AWS Cloud9 development environment.
|
default DescribeEnvironmentMembershipsResponse |
describeEnvironmentMemberships(DescribeEnvironmentMembershipsRequest describeEnvironmentMembershipsRequest)
Gets information about environment members for an AWS Cloud9 development environment.
|
default DescribeEnvironmentMembershipsIterable |
describeEnvironmentMembershipsPaginator()
Gets information about environment members for an AWS Cloud9 development environment.
|
default DescribeEnvironmentMembershipsIterable |
describeEnvironmentMembershipsPaginator(Consumer<DescribeEnvironmentMembershipsRequest.Builder> describeEnvironmentMembershipsRequest)
Gets information about environment members for an AWS Cloud9 development environment.
|
default DescribeEnvironmentMembershipsIterable |
describeEnvironmentMembershipsPaginator(DescribeEnvironmentMembershipsRequest describeEnvironmentMembershipsRequest)
Gets information about environment members for an AWS Cloud9 development environment.
|
default DescribeEnvironmentsResponse |
describeEnvironments(Consumer<DescribeEnvironmentsRequest.Builder> describeEnvironmentsRequest)
Gets information about AWS Cloud9 development environments.
|
default DescribeEnvironmentsResponse |
describeEnvironments(DescribeEnvironmentsRequest describeEnvironmentsRequest)
Gets information about AWS Cloud9 development environments.
|
default DescribeEnvironmentStatusResponse |
describeEnvironmentStatus(Consumer<DescribeEnvironmentStatusRequest.Builder> describeEnvironmentStatusRequest)
Gets status information for an AWS Cloud9 development environment.
|
default DescribeEnvironmentStatusResponse |
describeEnvironmentStatus(DescribeEnvironmentStatusRequest describeEnvironmentStatusRequest)
Gets status information for an AWS Cloud9 development environment.
|
default ListEnvironmentsResponse |
listEnvironments()
Gets a list of AWS Cloud9 development environment identifiers.
|
default ListEnvironmentsResponse |
listEnvironments(Consumer<ListEnvironmentsRequest.Builder> listEnvironmentsRequest)
Gets a list of AWS Cloud9 development environment identifiers.
|
default ListEnvironmentsResponse |
listEnvironments(ListEnvironmentsRequest listEnvironmentsRequest)
Gets a list of AWS Cloud9 development environment identifiers.
|
default ListEnvironmentsIterable |
listEnvironmentsPaginator()
Gets a list of AWS Cloud9 development environment identifiers.
|
default ListEnvironmentsIterable |
listEnvironmentsPaginator(Consumer<ListEnvironmentsRequest.Builder> listEnvironmentsRequest)
Gets a list of AWS Cloud9 development environment identifiers.
|
default ListEnvironmentsIterable |
listEnvironmentsPaginator(ListEnvironmentsRequest listEnvironmentsRequest)
Gets a list of AWS Cloud9 development environment identifiers.
|
static ServiceMetadata |
serviceMetadata() |
default UpdateEnvironmentResponse |
updateEnvironment(Consumer<UpdateEnvironmentRequest.Builder> updateEnvironmentRequest)
Changes the settings of an existing AWS Cloud9 development environment.
|
default UpdateEnvironmentResponse |
updateEnvironment(UpdateEnvironmentRequest updateEnvironmentRequest)
Changes the settings of an existing AWS Cloud9 development environment.
|
default UpdateEnvironmentMembershipResponse |
updateEnvironmentMembership(Consumer<UpdateEnvironmentMembershipRequest.Builder> updateEnvironmentMembershipRequest)
Changes the settings of an existing environment member for an AWS Cloud9 development environment.
|
default UpdateEnvironmentMembershipResponse |
updateEnvironmentMembership(UpdateEnvironmentMembershipRequest updateEnvironmentMembershipRequest)
Changes the settings of an existing environment member for an AWS Cloud9 development environment.
|
serviceNameclosestatic final String SERVICE_NAME
static Cloud9Client create()
Cloud9Client with the region loaded from the
DefaultAwsRegionProviderChain and credentials loaded from the
DefaultCredentialsProvider.static Cloud9ClientBuilder builder()
Cloud9Client.default CreateEnvironmentEc2Response createEnvironmentEC2(CreateEnvironmentEc2Request createEnvironmentEc2Request) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Creates an AWS Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance, and then connects from the instance to the environment.
createEnvironmentEc2Request - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault CreateEnvironmentEc2Response createEnvironmentEC2(Consumer<CreateEnvironmentEc2Request.Builder> createEnvironmentEc2Request) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Creates an AWS Cloud9 development environment, launches an Amazon Elastic Compute Cloud (Amazon EC2) instance, and then connects from the instance to the environment.
This is a convenience which creates an instance of the CreateEnvironmentEc2Request.Builder avoiding the
need to create one manually via CreateEnvironmentEc2Request.builder()
createEnvironmentEc2Request - A Consumer that will call methods on CreateEnvironmentEC2Request.Builder to create a
request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault CreateEnvironmentMembershipResponse createEnvironmentMembership(CreateEnvironmentMembershipRequest createEnvironmentMembershipRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Adds an environment member to an AWS Cloud9 development environment.
createEnvironmentMembershipRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault CreateEnvironmentMembershipResponse createEnvironmentMembership(Consumer<CreateEnvironmentMembershipRequest.Builder> createEnvironmentMembershipRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Adds an environment member to an AWS Cloud9 development environment.
This is a convenience which creates an instance of the CreateEnvironmentMembershipRequest.Builder
avoiding the need to create one manually via CreateEnvironmentMembershipRequest.builder()
createEnvironmentMembershipRequest - A Consumer that will call methods on CreateEnvironmentMembershipRequest.Builder to create
a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteEnvironmentResponse deleteEnvironment(DeleteEnvironmentRequest deleteEnvironmentRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Deletes an AWS Cloud9 development environment. If an Amazon EC2 instance is connected to the environment, also terminates the instance.
deleteEnvironmentRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteEnvironmentResponse deleteEnvironment(Consumer<DeleteEnvironmentRequest.Builder> deleteEnvironmentRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Deletes an AWS Cloud9 development environment. If an Amazon EC2 instance is connected to the environment, also terminates the instance.
This is a convenience which creates an instance of the DeleteEnvironmentRequest.Builder avoiding the need
to create one manually via DeleteEnvironmentRequest.builder()
deleteEnvironmentRequest - A Consumer that will call methods on DeleteEnvironmentRequest.Builder to create a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteEnvironmentMembershipResponse deleteEnvironmentMembership(DeleteEnvironmentMembershipRequest deleteEnvironmentMembershipRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Deletes an environment member from an AWS Cloud9 development environment.
deleteEnvironmentMembershipRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DeleteEnvironmentMembershipResponse deleteEnvironmentMembership(Consumer<DeleteEnvironmentMembershipRequest.Builder> deleteEnvironmentMembershipRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Deletes an environment member from an AWS Cloud9 development environment.
This is a convenience which creates an instance of the DeleteEnvironmentMembershipRequest.Builder
avoiding the need to create one manually via DeleteEnvironmentMembershipRequest.builder()
deleteEnvironmentMembershipRequest - A Consumer that will call methods on DeleteEnvironmentMembershipRequest.Builder to create
a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentMembershipsResponse describeEnvironmentMemberships() throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about environment members for an AWS Cloud9 development environment.
BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondescribeEnvironmentMemberships(DescribeEnvironmentMembershipsRequest),
AWS API Documentationdefault DescribeEnvironmentMembershipsResponse describeEnvironmentMemberships(DescribeEnvironmentMembershipsRequest describeEnvironmentMembershipsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about environment members for an AWS Cloud9 development environment.
describeEnvironmentMembershipsRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentMembershipsResponse describeEnvironmentMemberships(Consumer<DescribeEnvironmentMembershipsRequest.Builder> describeEnvironmentMembershipsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about environment members for an AWS Cloud9 development environment.
This is a convenience which creates an instance of the DescribeEnvironmentMembershipsRequest.Builder
avoiding the need to create one manually via DescribeEnvironmentMembershipsRequest.builder()
describeEnvironmentMembershipsRequest - A Consumer that will call methods on DescribeEnvironmentMembershipsRequest.Builder to
create a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentMembershipsIterable describeEnvironmentMembershipsPaginator() throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about environment members for an AWS Cloud9 development environment.
This is a variant of
describeEnvironmentMemberships(software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client.describeEnvironmentMembershipsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client
.describeEnvironmentMembershipsPaginator(request);
for (software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client.describeEnvironmentMembershipsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeEnvironmentMemberships(software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsRequest)
operation.
BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondescribeEnvironmentMembershipsPaginator(DescribeEnvironmentMembershipsRequest),
AWS API Documentationdefault DescribeEnvironmentMembershipsIterable describeEnvironmentMembershipsPaginator(DescribeEnvironmentMembershipsRequest describeEnvironmentMembershipsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about environment members for an AWS Cloud9 development environment.
This is a variant of
describeEnvironmentMemberships(software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client.describeEnvironmentMembershipsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client
.describeEnvironmentMembershipsPaginator(request);
for (software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client.describeEnvironmentMembershipsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeEnvironmentMemberships(software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsRequest)
operation.
describeEnvironmentMembershipsRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentMembershipsIterable describeEnvironmentMembershipsPaginator(Consumer<DescribeEnvironmentMembershipsRequest.Builder> describeEnvironmentMembershipsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about environment members for an AWS Cloud9 development environment.
This is a variant of
describeEnvironmentMemberships(software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsRequest)
operation. The return type is a custom iterable that can be used to iterate through all the pages. SDK will
internally handle making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client.describeEnvironmentMembershipsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client
.describeEnvironmentMembershipsPaginator(request);
for (software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.cloud9.paginators.DescribeEnvironmentMembershipsIterable responses = client.describeEnvironmentMembershipsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
describeEnvironmentMemberships(software.amazon.awssdk.services.cloud9.model.DescribeEnvironmentMembershipsRequest)
operation.
This is a convenience which creates an instance of the DescribeEnvironmentMembershipsRequest.Builder
avoiding the need to create one manually via DescribeEnvironmentMembershipsRequest.builder()
describeEnvironmentMembershipsRequest - A Consumer that will call methods on DescribeEnvironmentMembershipsRequest.Builder to
create a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentStatusResponse describeEnvironmentStatus(DescribeEnvironmentStatusRequest describeEnvironmentStatusRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets status information for an AWS Cloud9 development environment.
describeEnvironmentStatusRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentStatusResponse describeEnvironmentStatus(Consumer<DescribeEnvironmentStatusRequest.Builder> describeEnvironmentStatusRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets status information for an AWS Cloud9 development environment.
This is a convenience which creates an instance of the DescribeEnvironmentStatusRequest.Builder avoiding
the need to create one manually via DescribeEnvironmentStatusRequest.builder()
describeEnvironmentStatusRequest - A Consumer that will call methods on DescribeEnvironmentStatusRequest.Builder to create a
request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentsResponse describeEnvironments(DescribeEnvironmentsRequest describeEnvironmentsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about AWS Cloud9 development environments.
describeEnvironmentsRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault DescribeEnvironmentsResponse describeEnvironments(Consumer<DescribeEnvironmentsRequest.Builder> describeEnvironmentsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets information about AWS Cloud9 development environments.
This is a convenience which creates an instance of the DescribeEnvironmentsRequest.Builder avoiding the
need to create one manually via DescribeEnvironmentsRequest.builder()
describeEnvironmentsRequest - A Consumer that will call methods on DescribeEnvironmentsRequest.Builder to create a
request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEnvironmentsResponse listEnvironments() throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets a list of AWS Cloud9 development environment identifiers.
BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionlistEnvironments(ListEnvironmentsRequest),
AWS API
Documentationdefault ListEnvironmentsResponse listEnvironments(ListEnvironmentsRequest listEnvironmentsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets a list of AWS Cloud9 development environment identifiers.
listEnvironmentsRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEnvironmentsResponse listEnvironments(Consumer<ListEnvironmentsRequest.Builder> listEnvironmentsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets a list of AWS Cloud9 development environment identifiers.
This is a convenience which creates an instance of the ListEnvironmentsRequest.Builder avoiding the need
to create one manually via ListEnvironmentsRequest.builder()
listEnvironmentsRequest - A Consumer that will call methods on ListEnvironmentsRequest.Builder to create a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEnvironmentsIterable listEnvironmentsPaginator() throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets a list of AWS Cloud9 development environment identifiers.
This is a variant of
listEnvironments(software.amazon.awssdk.services.cloud9.model.ListEnvironmentsRequest) operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client.listEnvironmentsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client
.listEnvironmentsPaginator(request);
for (software.amazon.awssdk.services.cloud9.model.ListEnvironmentsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client.listEnvironmentsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listEnvironments(software.amazon.awssdk.services.cloud9.model.ListEnvironmentsRequest) operation.
BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionlistEnvironmentsPaginator(ListEnvironmentsRequest),
AWS API
Documentationdefault ListEnvironmentsIterable listEnvironmentsPaginator(ListEnvironmentsRequest listEnvironmentsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets a list of AWS Cloud9 development environment identifiers.
This is a variant of
listEnvironments(software.amazon.awssdk.services.cloud9.model.ListEnvironmentsRequest) operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client.listEnvironmentsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client
.listEnvironmentsPaginator(request);
for (software.amazon.awssdk.services.cloud9.model.ListEnvironmentsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client.listEnvironmentsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listEnvironments(software.amazon.awssdk.services.cloud9.model.ListEnvironmentsRequest) operation.
listEnvironmentsRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault ListEnvironmentsIterable listEnvironmentsPaginator(Consumer<ListEnvironmentsRequest.Builder> listEnvironmentsRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Gets a list of AWS Cloud9 development environment identifiers.
This is a variant of
listEnvironments(software.amazon.awssdk.services.cloud9.model.ListEnvironmentsRequest) operation. The
return type is a custom iterable that can be used to iterate through all the pages. SDK will internally handle
making service calls for you.
When this operation is called, a custom iterable is returned but no service calls are made yet. So there is no guarantee that the request is valid. As you iterate through the iterable, SDK will start lazily loading response pages by making service calls until there are no pages left or your iteration stops. If there are errors in your request, you will see the failures only after you start iterating through the iterable.
The following are few ways to iterate through the response pages:
1) Using a Stream
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client.listEnvironmentsPaginator(request);
responses.stream().forEach(....);
2) Using For loop
{
@code
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client
.listEnvironmentsPaginator(request);
for (software.amazon.awssdk.services.cloud9.model.ListEnvironmentsResponse response : responses) {
// do something;
}
}
3) Use iterator directly
software.amazon.awssdk.services.cloud9.paginators.ListEnvironmentsIterable responses = client.listEnvironmentsPaginator(request);
responses.iterator().forEachRemaining(....);
Note: If you prefer to have control on service calls, use the
listEnvironments(software.amazon.awssdk.services.cloud9.model.ListEnvironmentsRequest) operation.
This is a convenience which creates an instance of the ListEnvironmentsRequest.Builder avoiding the need
to create one manually via ListEnvironmentsRequest.builder()
listEnvironmentsRequest - A Consumer that will call methods on ListEnvironmentsRequest.Builder to create a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UpdateEnvironmentResponse updateEnvironment(UpdateEnvironmentRequest updateEnvironmentRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Changes the settings of an existing AWS Cloud9 development environment.
updateEnvironmentRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UpdateEnvironmentResponse updateEnvironment(Consumer<UpdateEnvironmentRequest.Builder> updateEnvironmentRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Changes the settings of an existing AWS Cloud9 development environment.
This is a convenience which creates an instance of the UpdateEnvironmentRequest.Builder avoiding the need
to create one manually via UpdateEnvironmentRequest.builder()
updateEnvironmentRequest - A Consumer that will call methods on UpdateEnvironmentRequest.Builder to create a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UpdateEnvironmentMembershipResponse updateEnvironmentMembership(UpdateEnvironmentMembershipRequest updateEnvironmentMembershipRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Changes the settings of an existing environment member for an AWS Cloud9 development environment.
updateEnvironmentMembershipRequest - BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptiondefault UpdateEnvironmentMembershipResponse updateEnvironmentMembership(Consumer<UpdateEnvironmentMembershipRequest.Builder> updateEnvironmentMembershipRequest) throws BadRequestException, ConflictException, NotFoundException, ForbiddenException, TooManyRequestsException, LimitExceededException, InternalServerErrorException, AwsServiceException, SdkClientException, Cloud9Exception
Changes the settings of an existing environment member for an AWS Cloud9 development environment.
This is a convenience which creates an instance of the UpdateEnvironmentMembershipRequest.Builder
avoiding the need to create one manually via UpdateEnvironmentMembershipRequest.builder()
updateEnvironmentMembershipRequest - A Consumer that will call methods on UpdateEnvironmentMembershipRequest.Builder to create
a request.BadRequestException - The target request is invalid.ConflictException - A conflict occurred.NotFoundException - The target resource cannot be found.ForbiddenException - An access permissions issue occurred.TooManyRequestsException - Too many service requests were made over the given time period.LimitExceededException - A service limit was exceeded.InternalServerErrorException - An internal server error occurred.SdkException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for
catch all scenarios.SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc.Cloud9Exception - Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.AwsServiceExceptionstatic ServiceMetadata serviceMetadata()
Copyright © 2019. All rights reserved.