google-native logo
Google Cloud Native v0.28.0, Feb 2 23

google-native.apigee/v1.Api

Creates an API proxy. The API proxy created will not be accessible at runtime until it is deployed to an environment. Create a new API proxy by setting the name query parameter to the name of the API proxy. Import an API proxy configuration bundle stored in zip format on your local machine to your organization by doing the following: * Set the name query parameter to the name of the API proxy. * Set the action query parameter to import. * Set the Content-Type header to multipart/form-data. * Pass as a file the name of API proxy configuration bundle stored in zip format on your local machine using the file form field. Note: To validate the API proxy configuration bundle only without importing it, set the action query parameter to validate. When importing an API proxy configuration bundle, if the API proxy does not exist, it will be created. If the API proxy exists, then a new revision is created. Invalid API proxy configurations are rejected, and a list of validation errors is returned to the client.

Create Api Resource

new Api(name: string, args: ApiArgs, opts?: CustomResourceOptions);
@overload
def Api(resource_name: str,
        opts: Optional[ResourceOptions] = None,
        action: Optional[str] = None,
        content_type: Optional[str] = None,
        data: Optional[str] = None,
        extensions: Optional[Sequence[Mapping[str, str]]] = None,
        file: Optional[Union[pulumi.Asset, pulumi.Archive]] = None,
        name: Optional[str] = None,
        organization_id: Optional[str] = None,
        validate: Optional[bool] = None)
@overload
def Api(resource_name: str,
        args: ApiArgs,
        opts: Optional[ResourceOptions] = None)
func NewApi(ctx *Context, name string, args ApiArgs, opts ...ResourceOption) (*Api, error)
public Api(string name, ApiArgs args, CustomResourceOptions? opts = null)
public Api(String name, ApiArgs args)
public Api(String name, ApiArgs args, CustomResourceOptions options)
type: google-native:apigee/v1:Api
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string
The unique name of the resource.
args ApiArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
resource_name str
The unique name of the resource.
args ApiArgs
The arguments to resource properties.
opts ResourceOptions
Bag of options to control resource's behavior.
ctx Context
Context object for the current deployment.
name string
The unique name of the resource.
args ApiArgs
The arguments to resource properties.
opts ResourceOption
Bag of options to control resource's behavior.
name string
The unique name of the resource.
args ApiArgs
The arguments to resource properties.
opts CustomResourceOptions
Bag of options to control resource's behavior.
name String
The unique name of the resource.
args ApiArgs
The arguments to resource properties.
options CustomResourceOptions
Bag of options to control resource's behavior.

Api Resource Properties

To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

Inputs

The Api resource accepts the following input properties:

OrganizationId string
Action string

Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values: * import to import the API proxy configuration bundle. * validate to validate the API proxy configuration bundle without importing it.

ContentType string

The HTTP Content-Type header value specifying the content type of the body.

Data string

The HTTP request/response body as raw binary.

Extensions List<ImmutableDictionary<string, string>>

Application specific response metadata. Must be set in the first response for streaming APIs.

File AssetOrArchive

File to upload.

Name string

Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-

Validate bool

Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.

OrganizationId string
Action string

Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values: * import to import the API proxy configuration bundle. * validate to validate the API proxy configuration bundle without importing it.

ContentType string

The HTTP Content-Type header value specifying the content type of the body.

Data string

The HTTP request/response body as raw binary.

Extensions []map[string]string

Application specific response metadata. Must be set in the first response for streaming APIs.

File pulumi.AssetOrArchive

File to upload.

Name string

Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-

Validate bool

Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.

organizationId String
action String

Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values: * import to import the API proxy configuration bundle. * validate to validate the API proxy configuration bundle without importing it.

contentType String

The HTTP Content-Type header value specifying the content type of the body.

data String

The HTTP request/response body as raw binary.

extensions List<Map<String,String>>

Application specific response metadata. Must be set in the first response for streaming APIs.

file AssetOrArchive

File to upload.

name String

Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-

validate Boolean

Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.

organizationId string
action string

Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values: * import to import the API proxy configuration bundle. * validate to validate the API proxy configuration bundle without importing it.

contentType string

The HTTP Content-Type header value specifying the content type of the body.

data string

The HTTP request/response body as raw binary.

extensions {[key: string]: string}[]

Application specific response metadata. Must be set in the first response for streaming APIs.

file pulumi.asset.Asset | pulumi.asset.Archive

File to upload.

name string

Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-

validate boolean

Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.

organization_id str
action str

Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values: * import to import the API proxy configuration bundle. * validate to validate the API proxy configuration bundle without importing it.

content_type str

The HTTP Content-Type header value specifying the content type of the body.

data str

The HTTP request/response body as raw binary.

extensions Sequence[Mapping[str, str]]

Application specific response metadata. Must be set in the first response for streaming APIs.

file Union[pulumi.Asset, pulumi.Archive]

File to upload.

name str

Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-

validate bool

Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.

organizationId String
action String

Action to perform when importing an API proxy configuration bundle. Set this parameter to one of the following values: * import to import the API proxy configuration bundle. * validate to validate the API proxy configuration bundle without importing it.

contentType String

The HTTP Content-Type header value specifying the content type of the body.

data String

The HTTP request/response body as raw binary.

extensions List<Map<String>>

Application specific response metadata. Must be set in the first response for streaming APIs.

file Asset

File to upload.

name String

Name of the API proxy. Restrict the characters used to: A-Za-z0-9._-

validate Boolean

Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.

Outputs

All input properties are implicitly available as output properties. Additionally, the Api resource produces the following output properties:

ApiProxyType string

The type of the API proxy.

Id string

The provider-assigned unique ID for this managed resource.

Labels Dictionary<string, string>

User labels applied to this API Proxy.

LatestRevisionId string

The id of the most recently created revision for this api proxy.

MetaData Pulumi.GoogleNative.Apigee.V1.Outputs.GoogleCloudApigeeV1EntityMetadataResponse

Metadata describing the API proxy.

ReadOnly bool

Whether this proxy is read-only. A read-only proxy cannot have new revisions created through calls to CreateApiProxyRevision. A proxy is read-only if it was generated by an archive.

Revision List<string>

List of revisions defined for the API proxy.

ApiProxyType string

The type of the API proxy.

Id string

The provider-assigned unique ID for this managed resource.

Labels map[string]string

User labels applied to this API Proxy.

LatestRevisionId string

The id of the most recently created revision for this api proxy.

MetaData GoogleCloudApigeeV1EntityMetadataResponse

Metadata describing the API proxy.

ReadOnly bool

Whether this proxy is read-only. A read-only proxy cannot have new revisions created through calls to CreateApiProxyRevision. A proxy is read-only if it was generated by an archive.

Revision []string

List of revisions defined for the API proxy.

apiProxyType String

The type of the API proxy.

id String

The provider-assigned unique ID for this managed resource.

labels Map<String,String>

User labels applied to this API Proxy.

latestRevisionId String

The id of the most recently created revision for this api proxy.

metaData GoogleCloudApigeeV1EntityMetadataResponse

Metadata describing the API proxy.

readOnly Boolean

Whether this proxy is read-only. A read-only proxy cannot have new revisions created through calls to CreateApiProxyRevision. A proxy is read-only if it was generated by an archive.

revision List<String>

List of revisions defined for the API proxy.

apiProxyType string

The type of the API proxy.

id string

The provider-assigned unique ID for this managed resource.

labels {[key: string]: string}

User labels applied to this API Proxy.

latestRevisionId string

The id of the most recently created revision for this api proxy.

metaData GoogleCloudApigeeV1EntityMetadataResponse

Metadata describing the API proxy.

readOnly boolean

Whether this proxy is read-only. A read-only proxy cannot have new revisions created through calls to CreateApiProxyRevision. A proxy is read-only if it was generated by an archive.

revision string[]

List of revisions defined for the API proxy.

api_proxy_type str

The type of the API proxy.

id str

The provider-assigned unique ID for this managed resource.

labels Mapping[str, str]

User labels applied to this API Proxy.

latest_revision_id str

The id of the most recently created revision for this api proxy.

meta_data GoogleCloudApigeeV1EntityMetadataResponse

Metadata describing the API proxy.

read_only bool

Whether this proxy is read-only. A read-only proxy cannot have new revisions created through calls to CreateApiProxyRevision. A proxy is read-only if it was generated by an archive.

revision Sequence[str]

List of revisions defined for the API proxy.

apiProxyType String

The type of the API proxy.

id String

The provider-assigned unique ID for this managed resource.

labels Map<String>

User labels applied to this API Proxy.

latestRevisionId String

The id of the most recently created revision for this api proxy.

metaData Property Map

Metadata describing the API proxy.

readOnly Boolean

Whether this proxy is read-only. A read-only proxy cannot have new revisions created through calls to CreateApiProxyRevision. A proxy is read-only if it was generated by an archive.

revision List<String>

List of revisions defined for the API proxy.

Supporting Types

GoogleCloudApigeeV1EntityMetadataResponse

CreatedAt string

Time at which the API proxy was created, in milliseconds since epoch.

LastModifiedAt string

Time at which the API proxy was most recently modified, in milliseconds since epoch.

SubType string

The type of entity described

CreatedAt string

Time at which the API proxy was created, in milliseconds since epoch.

LastModifiedAt string

Time at which the API proxy was most recently modified, in milliseconds since epoch.

SubType string

The type of entity described

createdAt String

Time at which the API proxy was created, in milliseconds since epoch.

lastModifiedAt String

Time at which the API proxy was most recently modified, in milliseconds since epoch.

subType String

The type of entity described

createdAt string

Time at which the API proxy was created, in milliseconds since epoch.

lastModifiedAt string

Time at which the API proxy was most recently modified, in milliseconds since epoch.

subType string

The type of entity described

created_at str

Time at which the API proxy was created, in milliseconds since epoch.

last_modified_at str

Time at which the API proxy was most recently modified, in milliseconds since epoch.

sub_type str

The type of entity described

createdAt String

Time at which the API proxy was created, in milliseconds since epoch.

lastModifiedAt String

Time at which the API proxy was most recently modified, in milliseconds since epoch.

subType String

The type of entity described

Package Details

Repository
Google Cloud Native pulumi/pulumi-google-native
License
Apache-2.0