Create an Access Point
POST/networking/v1/access-points
Make a request to create an access point.
Request
Responses
- 202
- 400
- 401
- 403
- 409
- 422
- 429
- 500
An Access Point is being created.
Response Headers
X-Request-Id
The unique identifier for the API request.
X-RateLimit-Limit
The maximum number of requests you're permitted to make per time period.
X-RateLimit-Remaining
The number of requests remaining in the current rate limit window.
X-RateLimit-Reset
The relative time in seconds until the current rate-limit window resets.
Important: This differs from Github and Twitter's same-named header which uses UTC epoch seconds. We use relative time to avoid client/server time synchronization issues.
Location
AccessPoint resource uri
Bad Request
Response Headers
X-Request-Id
The unique identifier for the API request.
The request lacks valid authentication credentials for this resource.
Response Headers
X-Request-Id
The unique identifier for the API request.
WWW-Authenticate
The unique identifier for the API request.
Example:
Basic error="invalid_key", error_description="The API Key is invalid"The access credentials were considered insufficient to grant access
Response Headers
X-Request-Id
The unique identifier for the API request.
The request is in conflict with the current server state
Response Headers
X-Request-Id
The unique identifier for the API request.
Location
Resource URI of conflicting resource
Validation Failed
Response Headers
X-Request-Id
The unique identifier for the API request.
Rate Limit Exceeded
Response Headers
X-Request-Id
The unique identifier for the API request.
X-RateLimit-Limit
The maximum number of requests you're permitted to make per time period.
X-RateLimit-Remaining
The number of requests remaining in the current rate limit window.
X-RateLimit-Reset
The relative time in seconds until the current rate-limit window resets.
Important: This differs from Github and Twitter's same-named header which uses UTC epoch seconds. We use relative time to avoid client/server time synchronization issues.
Retry-After
The number of seconds to wait until the rate limit window resets. Only sent when the rate limit is reached.
Oops, something went wrong!
Response Headers
X-Request-Id
The unique identifier for the API request.
OpenAPI definition (YAML)
paths:
/networking/v1/access-points:
post:
x-lifecycle-stage: General Availability
x-self-access: true
operationId: createNetworkingV1AccessPoint
description: '[](#section/Versioning/API-Lifecycle-Policy)
Make a request to create an access point.'
tags:
- Access Points (networking/v1)
security:
- cloud-api-key: []
- confluent-sts-access-token: []
requestBody:
content:
application/json:
schema:
allOf:
- type: object
description: 'AccessPoint objects represent network connections in and out of Gateways.
This API allows you to list, create, read, update, and delete your access points.
## The Access Points Model
<SchemaDefinition schemaRef="#/components/schemas/networking.v1.AccessPoint" />'
properties:
metadata:
allOf:
- description: ObjectMeta is metadata that all persisted resources must have, which
includes all objects users must create.
properties: {}
readOnly: true
title: ObjectMeta
- properties:
self:
example: https://api.confluent.cloud/networking/v1/access-points/ap-12345
resource_name:
example: crn://confluent.cloud/organization=9bb441c4-edef-46ac-8a41-c49e44a3fd9a/environment=env-abc123/gateway=gw-456xyz/access-point=ap-12345
spec:
type: object
description: The desired state of the Access Point
properties:
display_name:
type: string
description: The name of the access point.
example: prod-ap-egress-usw2
config:
type: object
oneOf:
- type: object
description: AWS VPC Endpoint.
required:
- kind
- vpc_endpoint_service_name
properties:
kind:
type: string
description: AwsEgressPrivateLinkEndpoint kind.
enum:
- AwsEgressPrivateLinkEndpoint
vpc_endpoint_service_name:
description: ID of the VPC Endpoint service used for PrivateLink.
type: string
minLength: 1
example: com.amazonaws.vpce.us-west-2.vpce-svc-00000000000000000
enable_high_availability:
type: boolean
description: Whether a resource should be provisioned with high availability.
Endpoints deployed with high availability have network interfaces deployed
in multiple AZs.
example: false
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system or
service that the PrivateLink Endpoint connects to (e.g. "MONGODB" or "SNOWFLAKE").'
example: S3
title: networking.v1.AwsEgressPrivateLinkEndpoint
- type: object
description: AWS Ingress Private Link Endpoint.
required:
- kind
- vpc_endpoint_id
properties:
kind:
type: string
description: AwsIngressPrivateLinkEndpoint kind.
enum:
- AwsIngressPrivateLinkEndpoint
vpc_endpoint_id:
description: ID of a VPC Endpoint that will be connected to the VPC Endpoint
service.
type: string
minLength: 1
example: vpce-00000000000000000
title: networking.v1.AwsIngressPrivateLinkEndpoint
- type: object
description: Azure Private Endpoint.
required:
- kind
- private_link_service_resource_id
properties:
kind:
type: string
description: AzureEgressPrivateLinkEndpoint kind.
enum:
- AzureEgressPrivateLinkEndpoint
private_link_service_resource_id:
description: Resource ID of the Azure Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/s-abcde/providers/Microsoft.Network/privateLinkServices/pls-plt-abcdef-az3
private_link_subresource_name:
type: string
description: Name of the subresource for the Private Endpoint to connect
to.
example: sqlServer
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system or
service that the PrivateLink Endpoint connects to (e.g. "MONGODB" or "SNOWFLAKE").'
example: SNOWFLAKE
title: networking.v1.AzureEgressPrivateLinkEndpoint
- type: object
description: Azure Ingress Private Link Endpoint.
required:
- kind
- private_endpoint_resource_id
properties:
kind:
type: string
description: AzureIngressPrivateLinkEndpoint kind.
enum:
- AzureIngressPrivateLinkEndpoint
private_endpoint_resource_id:
description: Resource ID of a Private Endpoint that will be connected to
the Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-centralus-rg/providers/Microsoft.Network/privateEndpoints/private-endpoint-azure-centralus
title: networking.v1.AzureIngressPrivateLinkEndpoint
- type: object
description: Confluent Private Network Interface powered by AWS ENI.
required:
- kind
properties:
kind:
type: string
description: AwsPrivateNetworkInterface kind.
enum:
- AwsPrivateNetworkInterface
network_interfaces:
description: List of the IDs of the Elastic Network Interfaces.
type: array
items:
type: string
uniqueItems: true
minItems: 51
example:
- eni-00000000000000000
- eni-00000000000000001
- eni-00000000000000002
- eni-00000000000000003
- eni-00000000000000004
- eni-00000000000000005
- eni-00000000000000006
- eni-00000000000000007
- eni-00000000000000008
- eni-00000000000000009
- eni-00000000000000010
- eni-00000000000000011
- eni-00000000000000012
- eni-00000000000000013
- eni-00000000000000014
- eni-00000000000000015
- eni-00000000000000016
- eni-00000000000000017
- eni-00000000000000018
- eni-00000000000000019
- eni-00000000000000020
- eni-00000000000000021
- eni-00000000000000022
- eni-00000000000000023
- eni-00000000000000024
- eni-00000000000000025
- eni-00000000000000026
- eni-00000000000000027
- eni-00000000000000028
- eni-00000000000000029
- eni-00000000000000030
- eni-00000000000000031
- eni-00000000000000032
- eni-00000000000000033
- eni-00000000000000034
- eni-00000000000000035
- eni-00000000000000036
- eni-00000000000000037
- eni-00000000000000038
- eni-00000000000000039
- eni-00000000000000040
- eni-00000000000000041
- eni-00000000000000042
- eni-00000000000000043
- eni-00000000000000044
- eni-00000000000000045
- eni-00000000000000046
- eni-00000000000000047
- eni-00000000000000048
- eni-00000000000000049
- eni-00000000000000050
account:
type: string
pattern: ^\d{12}$
example: '000000000000'
description: The AWS account ID associated with the ENIs you are using for
the Confluent Private Network Interface.
egress_routes:
type: array
description: List of egress CIDRs (IPv4) for egress PNI.
items:
type: string
uniqueItems: true
example:
- 10.0.0.0/16
- 10.1.0.0/16
- 10.2.0.0/16
- 172.16.0.0/16
title: networking.v1.AwsPrivateNetworkInterface
- type: object
description: GCP Private Service Connect Endpoint.
required:
- kind
- private_service_connect_endpoint_target
properties:
kind:
type: string
description: GcpEgressPrivateServiceConnectEndpoint kind.
enum:
- GcpEgressPrivateServiceConnectEndpoint
private_service_connect_endpoint_target:
description: URI of the service attachment for the published service that
the Private Service Connect Endpoint connects to or "ALL_GOOGLE_APIS"
for global Google APIs.
type: string
minLength: 1
example: projects/project-name/regions/us-central1/serviceAttachments/service-attachment-name
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system or
service that the PrivateLink Endpoint connects to (e.g. "GCS" or "SNOWFLAKE").'
example: GCS
title: networking.v1.GcpEgressPrivateServiceConnectEndpoint
- type: object
description: GCP Ingress Private Service Connect Endpoint.
required:
- kind
- private_service_connect_connection_id
properties:
kind:
type: string
description: GcpIngressPrivateServiceConnectEndpoint kind.
enum:
- GcpIngressPrivateServiceConnectEndpoint
private_service_connect_connection_id:
description: The ID of the Private Service Connect connection.
type: string
minLength: 1
example: '00000000000000000'
title: networking.v1.GcpIngressPrivateServiceConnectEndpoint
discriminator:
propertyName: kind
mapping:
AwsEgressPrivateLinkEndpoint:
type: object
description: AWS VPC Endpoint.
required:
- kind
- vpc_endpoint_service_name
properties:
kind:
type: string
description: AwsEgressPrivateLinkEndpoint kind.
enum:
- AwsEgressPrivateLinkEndpoint
vpc_endpoint_service_name:
description: ID of the VPC Endpoint service used for PrivateLink.
type: string
minLength: 1
example: com.amazonaws.vpce.us-west-2.vpce-svc-00000000000000000
enable_high_availability:
type: boolean
description: Whether a resource should be provisioned with high availability.
Endpoints deployed with high availability have network interfaces
deployed in multiple AZs.
example: false
x-immutable: true
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "MONGODB"
or "SNOWFLAKE").'
example: S3
title: networking.v1.AwsEgressPrivateLinkEndpoint
AwsIngressPrivateLinkEndpoint:
type: object
description: AWS Ingress Private Link Endpoint.
required:
- kind
- vpc_endpoint_id
properties:
kind:
type: string
description: AwsIngressPrivateLinkEndpoint kind.
enum:
- AwsIngressPrivateLinkEndpoint
vpc_endpoint_id:
description: ID of a VPC Endpoint that will be connected to the VPC
Endpoint service.
type: string
minLength: 1
example: vpce-00000000000000000
x-immutable: true
title: networking.v1.AwsIngressPrivateLinkEndpoint
AzureEgressPrivateLinkEndpoint:
type: object
description: Azure Private Endpoint.
required:
- kind
- private_link_service_resource_id
properties:
kind:
type: string
description: AzureEgressPrivateLinkEndpoint kind.
enum:
- AzureEgressPrivateLinkEndpoint
private_link_service_resource_id:
description: Resource ID of the Azure Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/s-abcde/providers/Microsoft.Network/privateLinkServices/pls-plt-abcdef-az3
private_link_subresource_name:
type: string
description: Name of the subresource for the Private Endpoint to connect
to.
example: sqlServer
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "MONGODB"
or "SNOWFLAKE").'
example: SNOWFLAKE
title: networking.v1.AzureEgressPrivateLinkEndpoint
AzureIngressPrivateLinkEndpoint:
type: object
description: Azure Ingress Private Link Endpoint.
required:
- kind
- private_endpoint_resource_id
properties:
kind:
type: string
description: AzureIngressPrivateLinkEndpoint kind.
enum:
- AzureIngressPrivateLinkEndpoint
private_endpoint_resource_id:
description: Resource ID of a Private Endpoint that will be connected
to the Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-centralus-rg/providers/Microsoft.Network/privateEndpoints/private-endpoint-azure-centralus
x-immutable: true
title: networking.v1.AzureIngressPrivateLinkEndpoint
AwsPrivateNetworkInterface:
type: object
description: Confluent Private Network Interface powered by AWS ENI.
required:
- kind
properties:
kind:
type: string
description: AwsPrivateNetworkInterface kind.
enum:
- AwsPrivateNetworkInterface
network_interfaces:
description: List of the IDs of the Elastic Network Interfaces.
type: array
items:
type: string
uniqueItems: true
minItems: 51
example:
- eni-00000000000000000
- eni-00000000000000001
- eni-00000000000000002
- eni-00000000000000003
- eni-00000000000000004
- eni-00000000000000005
- eni-00000000000000006
- eni-00000000000000007
- eni-00000000000000008
- eni-00000000000000009
- eni-00000000000000010
- eni-00000000000000011
- eni-00000000000000012
- eni-00000000000000013
- eni-00000000000000014
- eni-00000000000000015
- eni-00000000000000016
- eni-00000000000000017
- eni-00000000000000018
- eni-00000000000000019
- eni-00000000000000020
- eni-00000000000000021
- eni-00000000000000022
- eni-00000000000000023
- eni-00000000000000024
- eni-00000000000000025
- eni-00000000000000026
- eni-00000000000000027
- eni-00000000000000028
- eni-00000000000000029
- eni-00000000000000030
- eni-00000000000000031
- eni-00000000000000032
- eni-00000000000000033
- eni-00000000000000034
- eni-00000000000000035
- eni-00000000000000036
- eni-00000000000000037
- eni-00000000000000038
- eni-00000000000000039
- eni-00000000000000040
- eni-00000000000000041
- eni-00000000000000042
- eni-00000000000000043
- eni-00000000000000044
- eni-00000000000000045
- eni-00000000000000046
- eni-00000000000000047
- eni-00000000000000048
- eni-00000000000000049
- eni-00000000000000050
account:
type: string
pattern: ^\d{12}$
example: '000000000000'
description: The AWS account ID associated with the ENIs you are using
for the Confluent Private Network Interface.
x-immutable: true
egress_routes:
type: array
description: List of egress CIDRs (IPv4) for egress PNI.
items:
type: string
uniqueItems: true
example:
- 10.0.0.0/16
- 10.1.0.0/16
- 10.2.0.0/16
- 172.16.0.0/16
title: networking.v1.AwsPrivateNetworkInterface
GcpEgressPrivateServiceConnectEndpoint:
type: object
description: GCP Private Service Connect Endpoint.
required:
- kind
- private_service_connect_endpoint_target
properties:
kind:
type: string
description: GcpEgressPrivateServiceConnectEndpoint kind.
enum:
- GcpEgressPrivateServiceConnectEndpoint
private_service_connect_endpoint_target:
description: URI of the service attachment for the published service
that the Private Service Connect Endpoint connects to or "ALL_GOOGLE_APIS"
for global Google APIs.
type: string
minLength: 1
example: projects/project-name/regions/us-central1/serviceAttachments/service-attachment-name
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "GCS" or
"SNOWFLAKE").'
example: GCS
title: networking.v1.GcpEgressPrivateServiceConnectEndpoint
GcpIngressPrivateServiceConnectEndpoint:
type: object
description: GCP Ingress Private Service Connect Endpoint.
required:
- kind
- private_service_connect_connection_id
properties:
kind:
type: string
description: GcpIngressPrivateServiceConnectEndpoint kind.
enum:
- GcpIngressPrivateServiceConnectEndpoint
private_service_connect_connection_id:
description: The ID of the Private Service Connect connection.
type: string
minLength: 1
example: '00000000000000000'
title: networking.v1.GcpIngressPrivateServiceConnectEndpoint
description: The specific details of the different access point configurations.
environment:
allOf:
- type: object
description: ObjectReference provides information for you to locate the referred
object
required:
- id
properties:
id:
type: string
description: ID of the referred resource
minLength: 1
maxLength: 255
environment:
type: string
description: Environment of the referred resource, if env-scoped
minLength: 1
maxLength: 255
title: ObjectReference
description: The environment to which this belongs.
gateway:
allOf:
- type: object
description: ObjectReference provides information for you to locate the referred
object
required:
- id
properties:
id:
type: string
description: ID of the referred resource
minLength: 1
maxLength: 255
environment:
type: string
description: Environment of the referred resource, if env-scoped
minLength: 1
maxLength: 255
title: ObjectReference
description: The gateway to which this belongs.
x-enable-id: true
x-enable-listmeta: true
x-enable-objectmeta: true
title: networking.v1.AccessPointSpec
title: networking.v1.AccessPoint
- type: object
required:
- spec
properties:
spec:
type: object
required:
- config
- environment
- gateway
- type: object
properties:
spec:
type: object
properties:
environment:
example:
id: env-00000
gateway:
example:
id: gw-00000
responses:
'202':
description: An Access Point is being created.
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
X-RateLimit-Limit:
schema:
type: integer
description: The maximum number of requests you're permitted to make per time period.
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining in the current rate limit window.
X-RateLimit-Reset:
schema:
type: integer
description: "The relative time in seconds until the current rate-limit window resets. \
\ \n \n**Important:** This differs from Github and Twitter's same-named header which\
\ uses UTC epoch seconds. We use relative time to avoid client/server time synchronization\
\ issues."
Location:
schema:
type: string
format: uri
example: https://api.confluent.cloud/networking/v1/access-points/{id}
description: AccessPoint resource uri
content:
application/json:
schema:
allOf:
- type: object
description: 'AccessPoint objects represent network connections in and out of Gateways.
This API allows you to list, create, read, update, and delete your access points.
## The Access Points Model
<SchemaDefinition schemaRef="#/components/schemas/networking.v1.AccessPoint" />'
properties:
api_version:
type: string
enum:
- networking/v1
description: APIVersion defines the schema version of this representation of a resource.
readOnly: true
kind:
type: string
description: Kind defines the object this REST resource represents.
readOnly: true
enum:
- AccessPoint
id:
description: ID is the "natural identifier" for an object within its scope/namespace;
it is normally unique across time but not space. That is, you can assume that
the ID will not be reclaimed and reused after an object is deleted ("time"); however,
it may collide with IDs for other object `kinds` or objects of the same `kind`
within a different scope/namespace ("space").
type: string
maxLength: 255
readOnly: true
example: dlz-f3a90de
metadata:
allOf:
- description: ObjectMeta is metadata that all persisted resources must have, which
includes all objects users must create.
required:
- self
properties:
self:
description: Self is a Uniform Resource Locator (URL) at which an object can
be addressed. This URL encodes the service location, API version, and other
particulars necessary to locate the resource at a point in time
type: string
format: uri
readOnly: true
example: https://api.confluent.cloud/v2/kafka-clusters/lkc-f3a90de
resource_name:
description: Resource Name is a Uniform Resource Identifier (URI) that is
globally unique across space and time. It is represented as a Confluent
Resource Name
type: string
format: uri
readOnly: true
example: crn://confluent.cloud/kafka=lkc-f3a90de
created_at:
type: string
format: date-time
example: '2006-01-02T15:04:05-07:00'
readOnly: true
description: The date and time at which this object was created. It is represented
in RFC3339 format and is in UTC.
updated_at:
type: string
format: date-time
example: '2006-01-02T15:04:05-07:00'
readOnly: true
description: The date and time at which this object was last updated. It is
represented in RFC3339 format and is in UTC.
deleted_at:
type: string
format: date-time
example: '2006-01-02T15:04:05-07:00'
readOnly: true
description: The date and time at which this object was (or will be) deleted.
It is represented in RFC3339 format and is in UTC.
readOnly: true
title: ObjectMeta
- properties:
self:
example: https://api.confluent.cloud/networking/v1/access-points/ap-12345
resource_name:
example: crn://confluent.cloud/organization=9bb441c4-edef-46ac-8a41-c49e44a3fd9a/environment=env-abc123/gateway=gw-456xyz/access-point=ap-12345
spec:
type: object
description: The desired state of the Access Point
properties:
display_name:
type: string
description: The name of the access point.
example: prod-ap-egress-usw2
config:
type: object
oneOf:
- type: object
description: AWS VPC Endpoint.
required:
- kind
- vpc_endpoint_service_name
properties:
kind:
type: string
description: AwsEgressPrivateLinkEndpoint kind.
enum:
- AwsEgressPrivateLinkEndpoint
vpc_endpoint_service_name:
description: ID of the VPC Endpoint service used for PrivateLink.
type: string
minLength: 1
example: com.amazonaws.vpce.us-west-2.vpce-svc-00000000000000000
enable_high_availability:
type: boolean
description: Whether a resource should be provisioned with high availability.
Endpoints deployed with high availability have network interfaces deployed
in multiple AZs.
example: false
x-immutable: true
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "MONGODB"
or "SNOWFLAKE").'
example: S3
title: networking.v1.AwsEgressPrivateLinkEndpoint
- type: object
description: AWS Ingress Private Link Endpoint.
required:
- kind
- vpc_endpoint_id
properties:
kind:
type: string
description: AwsIngressPrivateLinkEndpoint kind.
enum:
- AwsIngressPrivateLinkEndpoint
vpc_endpoint_id:
description: ID of a VPC Endpoint that will be connected to the VPC Endpoint
service.
type: string
minLength: 1
example: vpce-00000000000000000
x-immutable: true
title: networking.v1.AwsIngressPrivateLinkEndpoint
- type: object
description: Azure Private Endpoint.
required:
- kind
- private_link_service_resource_id
properties:
kind:
type: string
description: AzureEgressPrivateLinkEndpoint kind.
enum:
- AzureEgressPrivateLinkEndpoint
private_link_service_resource_id:
description: Resource ID of the Azure Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/s-abcde/providers/Microsoft.Network/privateLinkServices/pls-plt-abcdef-az3
private_link_subresource_name:
type: string
description: Name of the subresource for the Private Endpoint to connect
to.
example: sqlServer
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "MONGODB"
or "SNOWFLAKE").'
example: SNOWFLAKE
title: networking.v1.AzureEgressPrivateLinkEndpoint
- type: object
description: Azure Ingress Private Link Endpoint.
required:
- kind
- private_endpoint_resource_id
properties:
kind:
type: string
description: AzureIngressPrivateLinkEndpoint kind.
enum:
- AzureIngressPrivateLinkEndpoint
private_endpoint_resource_id:
description: Resource ID of a Private Endpoint that will be connected
to the Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-centralus-rg/providers/Microsoft.Network/privateEndpoints/private-endpoint-azure-centralus
x-immutable: true
title: networking.v1.AzureIngressPrivateLinkEndpoint
- type: object
description: Confluent Private Network Interface powered by AWS ENI.
required:
- kind
properties:
kind:
type: string
description: AwsPrivateNetworkInterface kind.
enum:
- AwsPrivateNetworkInterface
network_interfaces:
description: List of the IDs of the Elastic Network Interfaces.
type: array
items:
type: string
uniqueItems: true
minItems: 51
example:
- eni-00000000000000000
- eni-00000000000000001
- eni-00000000000000002
- eni-00000000000000003
- eni-00000000000000004
- eni-00000000000000005
- eni-00000000000000006
- eni-00000000000000007
- eni-00000000000000008
- eni-00000000000000009
- eni-00000000000000010
- eni-00000000000000011
- eni-00000000000000012
- eni-00000000000000013
- eni-00000000000000014
- eni-00000000000000015
- eni-00000000000000016
- eni-00000000000000017
- eni-00000000000000018
- eni-00000000000000019
- eni-00000000000000020
- eni-00000000000000021
- eni-00000000000000022
- eni-00000000000000023
- eni-00000000000000024
- eni-00000000000000025
- eni-00000000000000026
- eni-00000000000000027
- eni-00000000000000028
- eni-00000000000000029
- eni-00000000000000030
- eni-00000000000000031
- eni-00000000000000032
- eni-00000000000000033
- eni-00000000000000034
- eni-00000000000000035
- eni-00000000000000036
- eni-00000000000000037
- eni-00000000000000038
- eni-00000000000000039
- eni-00000000000000040
- eni-00000000000000041
- eni-00000000000000042
- eni-00000000000000043
- eni-00000000000000044
- eni-00000000000000045
- eni-00000000000000046
- eni-00000000000000047
- eni-00000000000000048
- eni-00000000000000049
- eni-00000000000000050
account:
type: string
pattern: ^\d{12}$
example: '000000000000'
description: The AWS account ID associated with the ENIs you are using
for the Confluent Private Network Interface.
x-immutable: true
egress_routes:
type: array
description: List of egress CIDRs (IPv4) for egress PNI.
items:
type: string
uniqueItems: true
example:
- 10.0.0.0/16
- 10.1.0.0/16
- 10.2.0.0/16
- 172.16.0.0/16
title: networking.v1.AwsPrivateNetworkInterface
- type: object
description: GCP Private Service Connect Endpoint.
required:
- kind
- private_service_connect_endpoint_target
properties:
kind:
type: string
description: GcpEgressPrivateServiceConnectEndpoint kind.
enum:
- GcpEgressPrivateServiceConnectEndpoint
private_service_connect_endpoint_target:
description: URI of the service attachment for the published service that
the Private Service Connect Endpoint connects to or "ALL_GOOGLE_APIS"
for global Google APIs.
type: string
minLength: 1
example: projects/project-name/regions/us-central1/serviceAttachments/service-attachment-name
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "GCS" or
"SNOWFLAKE").'
example: GCS
title: networking.v1.GcpEgressPrivateServiceConnectEndpoint
- type: object
description: GCP Ingress Private Service Connect Endpoint.
required:
- kind
- private_service_connect_connection_id
properties:
kind:
type: string
description: GcpIngressPrivateServiceConnectEndpoint kind.
enum:
- GcpIngressPrivateServiceConnectEndpoint
private_service_connect_connection_id:
description: The ID of the Private Service Connect connection.
type: string
minLength: 1
example: '00000000000000000'
title: networking.v1.GcpIngressPrivateServiceConnectEndpoint
discriminator:
propertyName: kind
mapping:
AwsEgressPrivateLinkEndpoint:
type: object
description: AWS VPC Endpoint.
required:
- kind
- vpc_endpoint_service_name
properties:
kind:
type: string
description: AwsEgressPrivateLinkEndpoint kind.
enum:
- AwsEgressPrivateLinkEndpoint
vpc_endpoint_service_name:
description: ID of the VPC Endpoint service used for PrivateLink.
type: string
minLength: 1
example: com.amazonaws.vpce.us-west-2.vpce-svc-00000000000000000
enable_high_availability:
type: boolean
description: Whether a resource should be provisioned with high availability.
Endpoints deployed with high availability have network interfaces
deployed in multiple AZs.
example: false
x-immutable: true
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "MONGODB"
or "SNOWFLAKE").'
example: S3
title: networking.v1.AwsEgressPrivateLinkEndpoint
AwsIngressPrivateLinkEndpoint:
type: object
description: AWS Ingress Private Link Endpoint.
required:
- kind
- vpc_endpoint_id
properties:
kind:
type: string
description: AwsIngressPrivateLinkEndpoint kind.
enum:
- AwsIngressPrivateLinkEndpoint
vpc_endpoint_id:
description: ID of a VPC Endpoint that will be connected to the VPC
Endpoint service.
type: string
minLength: 1
example: vpce-00000000000000000
x-immutable: true
title: networking.v1.AwsIngressPrivateLinkEndpoint
AzureEgressPrivateLinkEndpoint:
type: object
description: Azure Private Endpoint.
required:
- kind
- private_link_service_resource_id
properties:
kind:
type: string
description: AzureEgressPrivateLinkEndpoint kind.
enum:
- AzureEgressPrivateLinkEndpoint
private_link_service_resource_id:
description: Resource ID of the Azure Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/s-abcde/providers/Microsoft.Network/privateLinkServices/pls-plt-abcdef-az3
private_link_subresource_name:
type: string
description: Name of the subresource for the Private Endpoint to connect
to.
example: sqlServer
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "MONGODB"
or "SNOWFLAKE").'
example: SNOWFLAKE
title: networking.v1.AzureEgressPrivateLinkEndpoint
AzureIngressPrivateLinkEndpoint:
type: object
description: Azure Ingress Private Link Endpoint.
required:
- kind
- private_endpoint_resource_id
properties:
kind:
type: string
description: AzureIngressPrivateLinkEndpoint kind.
enum:
- AzureIngressPrivateLinkEndpoint
private_endpoint_resource_id:
description: Resource ID of a Private Endpoint that will be connected
to the Private Link service.
type: string
minLength: 1
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-centralus-rg/providers/Microsoft.Network/privateEndpoints/private-endpoint-azure-centralus
x-immutable: true
title: networking.v1.AzureIngressPrivateLinkEndpoint
AwsPrivateNetworkInterface:
type: object
description: Confluent Private Network Interface powered by AWS ENI.
required:
- kind
properties:
kind:
type: string
description: AwsPrivateNetworkInterface kind.
enum:
- AwsPrivateNetworkInterface
network_interfaces:
description: List of the IDs of the Elastic Network Interfaces.
type: array
items:
type: string
uniqueItems: true
minItems: 51
example:
- eni-00000000000000000
- eni-00000000000000001
- eni-00000000000000002
- eni-00000000000000003
- eni-00000000000000004
- eni-00000000000000005
- eni-00000000000000006
- eni-00000000000000007
- eni-00000000000000008
- eni-00000000000000009
- eni-00000000000000010
- eni-00000000000000011
- eni-00000000000000012
- eni-00000000000000013
- eni-00000000000000014
- eni-00000000000000015
- eni-00000000000000016
- eni-00000000000000017
- eni-00000000000000018
- eni-00000000000000019
- eni-00000000000000020
- eni-00000000000000021
- eni-00000000000000022
- eni-00000000000000023
- eni-00000000000000024
- eni-00000000000000025
- eni-00000000000000026
- eni-00000000000000027
- eni-00000000000000028
- eni-00000000000000029
- eni-00000000000000030
- eni-00000000000000031
- eni-00000000000000032
- eni-00000000000000033
- eni-00000000000000034
- eni-00000000000000035
- eni-00000000000000036
- eni-00000000000000037
- eni-00000000000000038
- eni-00000000000000039
- eni-00000000000000040
- eni-00000000000000041
- eni-00000000000000042
- eni-00000000000000043
- eni-00000000000000044
- eni-00000000000000045
- eni-00000000000000046
- eni-00000000000000047
- eni-00000000000000048
- eni-00000000000000049
- eni-00000000000000050
account:
type: string
pattern: ^\d{12}$
example: '000000000000'
description: The AWS account ID associated with the ENIs you are using
for the Confluent Private Network Interface.
x-immutable: true
egress_routes:
type: array
description: List of egress CIDRs (IPv4) for egress PNI.
items:
type: string
uniqueItems: true
example:
- 10.0.0.0/16
- 10.1.0.0/16
- 10.2.0.0/16
- 172.16.0.0/16
title: networking.v1.AwsPrivateNetworkInterface
GcpEgressPrivateServiceConnectEndpoint:
type: object
description: GCP Private Service Connect Endpoint.
required:
- kind
- private_service_connect_endpoint_target
properties:
kind:
type: string
description: GcpEgressPrivateServiceConnectEndpoint kind.
enum:
- GcpEgressPrivateServiceConnectEndpoint
private_service_connect_endpoint_target:
description: URI of the service attachment for the published service
that the Private Service Connect Endpoint connects to or "ALL_GOOGLE_APIS"
for global Google APIs.
type: string
minLength: 1
example: projects/project-name/regions/us-central1/serviceAttachments/service-attachment-name
target_system:
type: string
description: '[Used by the Confluent Cloud Console] The target system
or service that the PrivateLink Endpoint connects to (e.g. "GCS"
or "SNOWFLAKE").'
example: GCS
title: networking.v1.GcpEgressPrivateServiceConnectEndpoint
GcpIngressPrivateServiceConnectEndpoint:
type: object
description: GCP Ingress Private Service Connect Endpoint.
required:
- kind
- private_service_connect_connection_id
properties:
kind:
type: string
description: GcpIngressPrivateServiceConnectEndpoint kind.
enum:
- GcpIngressPrivateServiceConnectEndpoint
private_service_connect_connection_id:
description: The ID of the Private Service Connect connection.
type: string
minLength: 1
example: '00000000000000000'
title: networking.v1.GcpIngressPrivateServiceConnectEndpoint
description: The specific details of the different access point configurations.
environment:
allOf:
- type: object
description: ObjectReference provides information for you to locate the referred
object
required:
- id
- related
- resource_name
properties:
id:
type: string
description: ID of the referred resource
minLength: 1
maxLength: 255
environment:
type: string
description: Environment of the referred resource, if env-scoped
minLength: 1
maxLength: 255
related:
type: string
format: uri
description: API URL for accessing or modifying the referred object
minLength: 1
readOnly: true
resource_name:
type: string
format: uri
description: CRN reference to the referred resource
minLength: 1
readOnly: true
api_version:
type: string
description: API group and version of the referred resource
minLength: 1
readOnly: true
kind:
type: string
description: Kind of the referred resource
minLength: 1
readOnly: true
title: ObjectReference
description: The environment to which this belongs.
gateway:
allOf:
- type: object
description: ObjectReference provides information for you to locate the referred
object
required:
- id
- related
- resource_name
properties:
id:
type: string
description: ID of the referred resource
minLength: 1
maxLength: 255
environment:
type: string
description: Environment of the referred resource, if env-scoped
minLength: 1
maxLength: 255
related:
type: string
format: uri
description: API URL for accessing or modifying the referred object
minLength: 1
readOnly: true
resource_name:
type: string
format: uri
description: CRN reference to the referred resource
minLength: 1
readOnly: true
api_version:
type: string
description: API group and version of the referred resource
minLength: 1
readOnly: true
kind:
type: string
description: Kind of the referred resource
minLength: 1
readOnly: true
title: ObjectReference
description: The gateway to which this belongs.
x-immutable: true
x-enable-id: true
x-enable-listmeta: true
x-enable-objectmeta: true
title: networking.v1.AccessPointSpec
status:
type: object
required:
- phase
description: The status of the Access Point
properties:
phase:
type: string
description: "The lifecycle phase of the access point:\n\n PROVISIONING: Access\
\ point provisioning is in progress;\n\n PENDING_ACCEPT: Access point connection\
\ request is pending acceptance by the customer;\n\n READY: Access point\
\ is ready;\n\n FAILED: Access point is in a failed state;\n\n DEPROVISIONING:\
\ Access point deprovisioning is in progress;\n\n DISCONNECTED: Access Point\
\ has been disconnected in the cloud provider by the customer;\n\n DEGRADED:\
\ Access Point is experiencing reduced performance or partial failure;\n\n\
\ ERROR: Invalid customer input during Access Point creation;\n"
readOnly: true
example: READY
enum:
- PROVISIONING
- PENDING_ACCEPT
- READY
- FAILED
- DEPROVISIONING
- DISCONNECTED
- DEGRADED
- ERROR
error_code:
type: string
description: Error code if access point is in a failed state. May be used for
programmatic error checking.
readOnly: true
error_message:
type: string
description: Displayable error message if access point is in a failed state.
readOnly: true
config:
type: object
oneOf:
- type: object
title: AWS
description: Status of an AWS PrivateLink Endpoint.
required:
- kind
- vpc_endpoint_id
- vpc_endpoint_dns_name
properties:
kind:
description: AwsEgressPrivateLinkEndpointStatus kind.
type: string
enum:
- AwsEgressPrivateLinkEndpointStatus
vpc_endpoint_id:
description: ID of a VPC Endpoint (if any) that is connected to the VPC
Endpoint service.
type: string
example: vpce-00000000000000000
readOnly: true
vpc_endpoint_dns_name:
description: DNS name of a VPC Endpoint (if any) that is connected to
the VPC Endpoint service.
type: string
example: vpce-00000000000000000-00000000.vpce-svc-00000000000000000.us-west-2.vpce.amazonaws.com
readOnly: true
- type: object
description: Status of an AWS Ingress Private Link Endpoint.
required:
- kind
- vpc_endpoint_service_name
- vpc_endpoint_id
properties:
kind:
description: AwsIngressPrivateLinkEndpointStatus kind.
type: string
enum:
- AwsIngressPrivateLinkEndpointStatus
vpc_endpoint_service_name:
description: ID of the Confluent Cloud VPC Endpoint service used for PrivateLink.
type: string
example: com.amazonaws.vpce.us-west-2.vpce-svc-00000000000000000
readOnly: true
vpc_endpoint_id:
description: ID of the VPC Endpoint used for connecting to the VPC Endpoint
service.
type: string
example: vpce-00000000000000000
readOnly: true
dns_domain:
description: DNS domain name used to configure the Private Hosted Zone
for the Access Point.
type: string
example: ap123abc.us-west-2.aws.accesspoint.confluent.cloud
readOnly: true
title: networking.v1.AwsIngressPrivateLinkEndpointStatus
- type: object
description: Status of an Azure Private Endpoint.
required:
- kind
- private_endpoint_resource_id
- private_endpoint_ip_address
properties:
kind:
description: AzureEgressPrivateLinkEndpointStatus kind.
type: string
enum:
- AzureEgressPrivateLinkEndpointStatus
private_endpoint_resource_id:
description: Resource ID of the Private Endpoint (if any) that is connected
to the Private Link service.
type: string
readOnly: true
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvpc/providers/Microsoft.Network/privateEndpoints/pe-plt-abcdef-az3
private_endpoint_domain:
description: Domain of the Private Endpoint (if any) that is connected
to the Private Link service.
type: string
readOnly: true
example: dbname.database.windows.net
private_endpoint_ip_address:
description: IP address of the Private Endpoint (if any) that is connected
to the Private Link service.
type: string
readOnly: true
example: 10.2.0.68
private_endpoint_custom_dns_config_domains:
description: Domains of the Private Endpoint (if any) based off FQDNs
in Azure custom DNS configs, which are required in your private DNS
setup.
type: array
items:
type: string
readOnly: true
example:
- dbname.database.windows.net
- dbname-region.database.windows.net
title: networking.v1.AzureEgressPrivateLinkEndpointStatus
- type: object
description: Status of an Azure Ingress Private Link Endpoint.
required:
- kind
- private_link_service_alias
- private_link_service_resource_id
- private_endpoint_resource_id
properties:
kind:
description: AzureIngressPrivateLinkEndpointStatus kind.
type: string
enum:
- AzureIngressPrivateLinkEndpointStatus
private_link_service_alias:
description: Alias of the Confluent Cloud Private Link Service.
type: string
readOnly: true
example: plattg-123abc-privatelink.00000000-0000-0000-0000-000000000000.centralus.azure.privatelinkservice
private_link_service_resource_id:
description: Resource ID of the Confluent Cloud Private Link Service.
type: string
readOnly: true
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/plattg-123abc/providers/Microsoft.Network/privateLinkServices/plattg-123abc-privatelink
private_endpoint_resource_id:
description: Resource ID of the Private Endpoint used for connecting to
the Private Link Service.
type: string
readOnly: true
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-centralus-rg/providers/Microsoft.Network/privateEndpoints/private-endpoint-azure-centralus
dns_domain:
description: DNS domain name used to configure the Private DNS Zone for
the Access Point.
type: string
example: ap123abc.centralus.azure.accesspoint.confluent.cloud
readOnly: true
title: networking.v1.AzureIngressPrivateLinkEndpointStatus
- type: object
description: Status of a GCP Private Service Connect Endpoint.
required:
- kind
- private_service_connect_endpoint_connection_id
- private_service_connect_endpoint_name
- private_service_connect_endpoint_ip_address
properties:
kind:
description: GcpEgressPrivateServiceConnectEndpointStatus kind.
type: string
enum:
- GcpEgressPrivateServiceConnectEndpointStatus
private_service_connect_endpoint_connection_id:
description: Connection ID of the Private Service Connect Endpoint (if
any) that is connected to the endpoint target.
type: string
readOnly: true
example: ''
private_service_connect_endpoint_name:
description: Name of the Private Service Connect Endpoint (if any) that
is connected to the endpoint target.
type: string
readOnly: true
example: plap-123456
private_service_connect_endpoint_ip_address:
description: IP address of the Private Service Connect Endpoint (if any)
that is connected to the endpoint target.
type: string
readOnly: true
example: 10.2.0.68
title: networking.v1.GcpEgressPrivateServiceConnectEndpointStatus
- type: object
description: Status of a GCP Ingress Private Service Connect Endpoint.
required:
- kind
- private_service_connect_service_attachment
- private_service_connect_connection_id
properties:
kind:
description: GcpIngressPrivateServiceConnectEndpointStatus kind.
type: string
enum:
- GcpIngressPrivateServiceConnectEndpointStatus
private_service_connect_service_attachment:
description: URI of the Private Service Connect Service Attachment in
Confluent Cloud.
type: string
readOnly: true
example: projects/traffic-prod/regions/us-central1/serviceAttachments/plattg-abc123-service-attachment
private_service_connect_connection_id:
description: The ID of the Private Service Connect connection.
type: string
readOnly: true
example: '00000000000000000'
dns_domain:
description: DNS domain name used to configure the DNS Zone for the Access
Point.
type: string
example: ap123abc.us-central1.gcp.accesspoint.confluent.cloud
readOnly: true
title: networking.v1.GcpIngressPrivateServiceConnectEndpointStatus
description: Cloud specific status of the access point.
discriminator:
propertyName: kind
mapping:
AwsEgressPrivateLinkEndpointStatus:
type: object
title: AWS
description: Status of an AWS PrivateLink Endpoint.
required:
- kind
- vpc_endpoint_id
- vpc_endpoint_dns_name
properties:
kind:
description: AwsEgressPrivateLinkEndpointStatus kind.
type: string
enum:
- AwsEgressPrivateLinkEndpointStatus
vpc_endpoint_id:
description: ID of a VPC Endpoint (if any) that is connected to the
VPC Endpoint service.
type: string
example: vpce-00000000000000000
readOnly: true
vpc_endpoint_dns_name:
description: DNS name of a VPC Endpoint (if any) that is connected
to the VPC Endpoint service.
type: string
example: vpce-00000000000000000-00000000.vpce-svc-00000000000000000.us-west-2.vpce.amazonaws.com
readOnly: true
AwsIngressPrivateLinkEndpointStatus:
type: object
description: Status of an AWS Ingress Private Link Endpoint.
required:
- kind
- vpc_endpoint_service_name
- vpc_endpoint_id
properties:
kind:
description: AwsIngressPrivateLinkEndpointStatus kind.
type: string
enum:
- AwsIngressPrivateLinkEndpointStatus
vpc_endpoint_service_name:
description: ID of the Confluent Cloud VPC Endpoint service used for
PrivateLink.
type: string
example: com.amazonaws.vpce.us-west-2.vpce-svc-00000000000000000
readOnly: true
vpc_endpoint_id:
description: ID of the VPC Endpoint used for connecting to the VPC
Endpoint service.
type: string
example: vpce-00000000000000000
readOnly: true
dns_domain:
description: DNS domain name used to configure the Private Hosted
Zone for the Access Point.
type: string
example: ap123abc.us-west-2.aws.accesspoint.confluent.cloud
readOnly: true
title: networking.v1.AwsIngressPrivateLinkEndpointStatus
AzureEgressPrivateLinkEndpointStatus:
type: object
description: Status of an Azure Private Endpoint.
required:
- kind
- private_endpoint_resource_id
- private_endpoint_ip_address
properties:
kind:
description: AzureEgressPrivateLinkEndpointStatus kind.
type: string
enum:
- AzureEgressPrivateLinkEndpointStatus
private_endpoint_resource_id:
description: Resource ID of the Private Endpoint (if any) that is
connected to the Private Link service.
type: string
readOnly: true
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testvpc/providers/Microsoft.Network/privateEndpoints/pe-plt-abcdef-az3
private_endpoint_domain:
description: Domain of the Private Endpoint (if any) that is connected
to the Private Link service.
type: string
readOnly: true
example: dbname.database.windows.net
private_endpoint_ip_address:
description: IP address of the Private Endpoint (if any) that is connected
to the Private Link service.
type: string
readOnly: true
example: 10.2.0.68
private_endpoint_custom_dns_config_domains:
description: Domains of the Private Endpoint (if any) based off FQDNs
in Azure custom DNS configs, which are required in your private
DNS setup.
type: array
items:
type: string
readOnly: true
example:
- dbname.database.windows.net
- dbname-region.database.windows.net
title: networking.v1.AzureEgressPrivateLinkEndpointStatus
AzureIngressPrivateLinkEndpointStatus:
type: object
description: Status of an Azure Ingress Private Link Endpoint.
required:
- kind
- private_link_service_alias
- private_link_service_resource_id
- private_endpoint_resource_id
properties:
kind:
description: AzureIngressPrivateLinkEndpointStatus kind.
type: string
enum:
- AzureIngressPrivateLinkEndpointStatus
private_link_service_alias:
description: Alias of the Confluent Cloud Private Link Service.
type: string
readOnly: true
example: plattg-123abc-privatelink.00000000-0000-0000-0000-000000000000.centralus.azure.privatelinkservice
private_link_service_resource_id:
description: Resource ID of the Confluent Cloud Private Link Service.
type: string
readOnly: true
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/plattg-123abc/providers/Microsoft.Network/privateLinkServices/plattg-123abc-privatelink
private_endpoint_resource_id:
description: Resource ID of the Private Endpoint used for connecting
to the Private Link Service.
type: string
readOnly: true
example: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/my-centralus-rg/providers/Microsoft.Network/privateEndpoints/private-endpoint-azure-centralus
dns_domain:
description: DNS domain name used to configure the Private DNS Zone
for the Access Point.
type: string
example: ap123abc.centralus.azure.accesspoint.confluent.cloud
readOnly: true
title: networking.v1.AzureIngressPrivateLinkEndpointStatus
GcpEgressPrivateServiceConnectEndpointStatus:
type: object
description: Status of a GCP Private Service Connect Endpoint.
required:
- kind
- private_service_connect_endpoint_connection_id
- private_service_connect_endpoint_name
- private_service_connect_endpoint_ip_address
properties:
kind:
description: GcpEgressPrivateServiceConnectEndpointStatus kind.
type: string
enum:
- GcpEgressPrivateServiceConnectEndpointStatus
private_service_connect_endpoint_connection_id:
description: Connection ID of the Private Service Connect Endpoint
(if any) that is connected to the endpoint target.
type: string
readOnly: true
example: ''
private_service_connect_endpoint_name:
description: Name of the Private Service Connect Endpoint (if any)
that is connected to the endpoint target.
type: string
readOnly: true
example: plap-123456
private_service_connect_endpoint_ip_address:
description: IP address of the Private Service Connect Endpoint (if
any) that is connected to the endpoint target.
type: string
readOnly: true
example: 10.2.0.68
title: networking.v1.GcpEgressPrivateServiceConnectEndpointStatus
GcpIngressPrivateServiceConnectEndpointStatus:
type: object
description: Status of a GCP Ingress Private Service Connect Endpoint.
required:
- kind
- private_service_connect_service_attachment
- private_service_connect_connection_id
properties:
kind:
description: GcpIngressPrivateServiceConnectEndpointStatus kind.
type: string
enum:
- GcpIngressPrivateServiceConnectEndpointStatus
private_service_connect_service_attachment:
description: URI of the Private Service Connect Service Attachment
in Confluent Cloud.
type: string
readOnly: true
example: projects/traffic-prod/regions/us-central1/serviceAttachments/plattg-abc123-service-attachment
private_service_connect_connection_id:
description: The ID of the Private Service Connect connection.
type: string
readOnly: true
example: '00000000000000000'
dns_domain:
description: DNS domain name used to configure the DNS Zone for the
Access Point.
type: string
example: ap123abc.us-central1.gcp.accesspoint.confluent.cloud
readOnly: true
title: networking.v1.GcpIngressPrivateServiceConnectEndpointStatus
readOnly: true
readOnly: true
title: networking.v1.AccessPointStatus
title: networking.v1.AccessPoint
- type: object
required:
- spec
- status
properties:
spec:
type: object
required:
- config
- environment
- gateway
- type: object
properties:
spec:
type: object
properties:
environment:
example:
id: env-00000
related: https://api.confluent.cloud/v2/environments/env-00000
resource_name: https://api.confluent.cloud/organization=9bb441c4-edef-46ac-8a41-c49e44a3fd9a/environment=env-00000
gateway:
example:
id: gw-00000
related: https://api.confluent.cloud/networking/v1/gateways/gw-00000
resource_name: https://api.confluent.cloud/organization=9bb441c4-edef-46ac-8a41-c49e44a3fd9a/environment=env-abc123/gateway=gw-00000
'400':
description: Bad Request
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/json:
schema:
type: object
description: Provides information about problems encountered while performing an operation.
required:
- errors
properties:
errors:
description: List of errors which caused this operation to fail
type: array
items:
type: object
description: Describes a particular error encountered while performing an operation.
properties:
id:
description: A unique identifier for this particular occurrence of the problem.
type: string
maxLength: 255
status:
description: The HTTP status code applicable to this problem, expressed as a
string value.
type: string
code:
description: An application-specific error code, expressed as a string value.
type: string
title:
description: A short, human-readable summary of the problem. It **SHOULD NOT**
change from occurrence to occurrence of the problem, except for purposes of
localization.
type: string
detail:
description: A human-readable explanation specific to this occurrence of the
problem.
type: string
source:
type: object
description: If this error was caused by a particular part of the API request,
the source will point to the query string parameter or request body property
that caused it.
properties:
pointer:
description: A JSON Pointer [RFC6901] to the associated entity in the request
document [e.g. "/spec" for a spec object, or "/spec/title" for a specific
field].
type: string
parameter:
description: A string indicating which query parameter caused the error.
type: string
error_code:
type: integer
format: int32
message:
type: string
nullable: true
additionalProperties: false
title: Error
uniqueItems: true
title: Failure
example:
errors:
- id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
status: '400'
code: invalid_filter
title: Invalid Filter
detail: The 'delorean' resource can't be filtered by 'num_doors'
source:
parameter: num_doors
'401':
x-summary: Unauthorized
description: The request lacks valid authentication credentials for this resource.
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
WWW-Authenticate:
schema:
type: string
description: The unique identifier for the API request.
example: Basic error="invalid_key", error_description="The API Key is invalid"
content:
application/json:
schema:
type: object
description: Provides information about problems encountered while performing an operation.
required:
- errors
properties:
errors:
description: List of errors which caused this operation to fail
type: array
items:
type: object
description: Describes a particular error encountered while performing an operation.
properties:
id:
description: A unique identifier for this particular occurrence of the problem.
type: string
maxLength: 255
status:
description: The HTTP status code applicable to this problem, expressed as a
string value.
type: string
code:
description: An application-specific error code, expressed as a string value.
type: string
title:
description: A short, human-readable summary of the problem. It **SHOULD NOT**
change from occurrence to occurrence of the problem, except for purposes of
localization.
type: string
detail:
description: A human-readable explanation specific to this occurrence of the
problem.
type: string
source:
type: object
description: If this error was caused by a particular part of the API request,
the source will point to the query string parameter or request body property
that caused it.
properties:
pointer:
description: A JSON Pointer [RFC6901] to the associated entity in the request
document [e.g. "/spec" for a spec object, or "/spec/title" for a specific
field].
type: string
parameter:
description: A string indicating which query parameter caused the error.
type: string
error_code:
type: integer
format: int32
message:
type: string
nullable: true
additionalProperties: false
title: Error
uniqueItems: true
title: Failure
example:
errors:
- id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
status: '401'
code: user_unauthenticated
title: Authentication Required
detail: Valid authentication credentials must be provided
'403':
x-summary: Forbidden
description: The access credentials were considered insufficient to grant access
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/json:
schema:
type: object
description: Provides information about problems encountered while performing an operation.
required:
- errors
properties:
errors:
description: List of errors which caused this operation to fail
type: array
items:
type: object
description: Describes a particular error encountered while performing an operation.
properties:
id:
description: A unique identifier for this particular occurrence of the problem.
type: string
maxLength: 255
status:
description: The HTTP status code applicable to this problem, expressed as a
string value.
type: string
code:
description: An application-specific error code, expressed as a string value.
type: string
title:
description: A short, human-readable summary of the problem. It **SHOULD NOT**
change from occurrence to occurrence of the problem, except for purposes of
localization.
type: string
detail:
description: A human-readable explanation specific to this occurrence of the
problem.
type: string
source:
type: object
description: If this error was caused by a particular part of the API request,
the source will point to the query string parameter or request body property
that caused it.
properties:
pointer:
description: A JSON Pointer [RFC6901] to the associated entity in the request
document [e.g. "/spec" for a spec object, or "/spec/title" for a specific
field].
type: string
parameter:
description: A string indicating which query parameter caused the error.
type: string
error_code:
type: integer
format: int32
message:
type: string
nullable: true
additionalProperties: false
title: Error
uniqueItems: true
title: Failure
example:
errors:
- id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
status: '403'
code: user_unauthorized
title: User Access Unauthorized
detail: The user 'mcfly' is not allowed to access the 'delorean' resource without the
'plutonium' role.
'409':
x-summary: Conflict
description: The request is in conflict with the current server state
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
Location:
schema:
type: string
format: uri
example: https://api.confluent.cloud/{object}/{id}
description: Resource URI of conflicting resource
content:
application/json:
schema:
type: object
description: Provides information about problems encountered while performing an operation.
required:
- errors
properties:
errors:
description: List of errors which caused this operation to fail
type: array
items:
type: object
description: Describes a particular error encountered while performing an operation.
properties:
id:
description: A unique identifier for this particular occurrence of the problem.
type: string
maxLength: 255
status:
description: The HTTP status code applicable to this problem, expressed as a
string value.
type: string
code:
description: An application-specific error code, expressed as a string value.
type: string
title:
description: A short, human-readable summary of the problem. It **SHOULD NOT**
change from occurrence to occurrence of the problem, except for purposes of
localization.
type: string
detail:
description: A human-readable explanation specific to this occurrence of the
problem.
type: string
source:
type: object
description: If this error was caused by a particular part of the API request,
the source will point to the query string parameter or request body property
that caused it.
properties:
pointer:
description: A JSON Pointer [RFC6901] to the associated entity in the request
document [e.g. "/spec" for a spec object, or "/spec/title" for a specific
field].
type: string
parameter:
description: A string indicating which query parameter caused the error.
type: string
error_code:
type: integer
format: int32
message:
type: string
nullable: true
additionalProperties: false
title: Error
uniqueItems: true
title: Failure
example:
errors:
- id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
status: '409'
code: resource_already_exists
title: Resource Already exists
detail: The entitlement '91e3e86f-fca6-4f14-98f5-a48e64113ce2' already exists.
'422':
description: Validation Failed
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/json:
schema:
type: object
description: Provides information about problems encountered while performing an operation.
required:
- errors
properties:
errors:
description: List of errors which caused this operation to fail
type: array
items:
type: object
description: Describes a particular error encountered while performing an operation.
properties:
id:
description: A unique identifier for this particular occurrence of the problem.
type: string
maxLength: 255
status:
description: The HTTP status code applicable to this problem, expressed as a
string value.
type: string
code:
description: An application-specific error code, expressed as a string value.
type: string
title:
description: A short, human-readable summary of the problem. It **SHOULD NOT**
change from occurrence to occurrence of the problem, except for purposes of
localization.
type: string
detail:
description: A human-readable explanation specific to this occurrence of the
problem.
type: string
source:
type: object
description: If this error was caused by a particular part of the API request,
the source will point to the query string parameter or request body property
that caused it.
properties:
pointer:
description: A JSON Pointer [RFC6901] to the associated entity in the request
document [e.g. "/spec" for a spec object, or "/spec/title" for a specific
field].
type: string
parameter:
description: A string indicating which query parameter caused the error.
type: string
error_code:
type: integer
format: int32
message:
type: string
nullable: true
additionalProperties: false
title: Error
uniqueItems: true
title: Failure
example:
errors:
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
- status: '422'
code: invalid_configuration
id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
title: Validation Failed
detail: 'The property ''/cluster/storage_size'' of type string did not match the following
type: integer'
source:
pointer: /cluster/storage_size
'429':
description: Rate Limit Exceeded
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
X-RateLimit-Limit:
schema:
type: integer
description: The maximum number of requests you're permitted to make per time period.
X-RateLimit-Remaining:
schema:
type: integer
description: The number of requests remaining in the current rate limit window.
X-RateLimit-Reset:
schema:
type: integer
description: "The relative time in seconds until the current rate-limit window resets. \
\ \n \n**Important:** This differs from Github and Twitter's same-named header which\
\ uses UTC epoch seconds. We use relative time to avoid client/server time synchronization\
\ issues."
Retry-After:
schema:
type: integer
description: The number of seconds to wait until the rate limit window resets. Only sent
when the rate limit is reached.
'500':
description: Oops, something went wrong!
headers:
X-Request-Id:
schema:
type: string
description: The unique identifier for the API request.
content:
application/json:
schema:
type: object
description: Provides information about problems encountered while performing an operation.
required:
- errors
properties:
errors:
description: List of errors which caused this operation to fail
type: array
items:
type: object
description: Describes a particular error encountered while performing an operation.
properties:
id:
description: A unique identifier for this particular occurrence of the problem.
type: string
maxLength: 255
status:
description: The HTTP status code applicable to this problem, expressed as a
string value.
type: string
code:
description: An application-specific error code, expressed as a string value.
type: string
title:
description: A short, human-readable summary of the problem. It **SHOULD NOT**
change from occurrence to occurrence of the problem, except for purposes of
localization.
type: string
detail:
description: A human-readable explanation specific to this occurrence of the
problem.
type: string
source:
type: object
description: If this error was caused by a particular part of the API request,
the source will point to the query string parameter or request body property
that caused it.
properties:
pointer:
description: A JSON Pointer [RFC6901] to the associated entity in the request
document [e.g. "/spec" for a spec object, or "/spec/title" for a specific
field].
type: string
parameter:
description: A string indicating which query parameter caused the error.
type: string
error_code:
type: integer
format: int32
message:
type: string
nullable: true
additionalProperties: false
title: Error
uniqueItems: true
title: Failure
example:
errors:
- id: ed42afdc-f0d5-4c0d-b428-9fc6ed6e279d
status: '500'
code: out_of_gas
title: DeLorean Out Of Gas
detail: The DeLorean has run out of gas, but Doc Brown will fill 'er up for you asap
servers:
- url: https://api.confluent.cloud
description: Confluent Cloud API
jsonRequestBodyExample:
spec:
display_name: prod-ap-egress-usw2
config:
kind: AwsEgressPrivateLinkEndpoint
vpc_endpoint_service_name: com.amazonaws.vpce.us-west-2.vpce-svc-00000000000000000
enable_high_availability: false
target_system: S3
environment:
id: env-00000
gateway:
id: gw-00000