GetApi

Use this data source to access information about an existing API Management API.

Example Usage

using Pulumi;
using Azure = Pulumi.Azure;

class MyStack : Stack
{
    public MyStack()
    {
        var example = Output.Create(Azure.ApiManagement.GetApi.InvokeAsync(new Azure.ApiManagement.GetApiArgs
        {
            Name = "search-api",
            ApiManagementName = "search-api-management",
            ResourceGroupName = "search-service",
            Revision = "2",
        }));
        this.ApiManagementApiId = example.Apply(example => example.Id);
    }

    [Output("apiManagementApiId")]
    public Output<string> ApiManagementApiId { get; set; }
}

package main

import (
    "github.com/pulumi/pulumi-azure/sdk/v3/go/azure/apimanagement"
    "github.com/pulumi/pulumi/sdk/v2/go/pulumi"
)

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        example, err := apimanagement.LookupApi(ctx, &apimanagement.LookupApiArgs{
            Name:              "search-api",
            ApiManagementName: "search-api-management",
            ResourceGroupName: "search-service",
            Revision:          "2",
        }, nil)
        if err != nil {
            return err
        }
        ctx.Export("apiManagementApiId", example.Id)
        return nil
    })
}

import pulumi
import pulumi_azure as azure

example = azure.apimanagement.get_api(name="search-api",
    api_management_name="search-api-management",
    resource_group_name="search-service",
    revision="2")
pulumi.export("apiManagementApiId", example.id)

import * as pulumi from "@pulumi/pulumi";
import * as azure from "@pulumi/azure";

const example = azure.apimanagement.getApi({
    name: "search-api",
    apiManagementName: "search-api-management",
    resourceGroupName: "search-service",
    revision: "2",
});
export const apiManagementApiId = example.then(example => example.id);

Using GetApi

function getApi(args: GetApiArgs, opts?: InvokeOptions): Promise<GetApiResult>

function  get_api(api_management_name=None, name=None, resource_group_name=None, revision=None, opts=None)

func LookupApi(ctx *Context, args *LookupApiArgs, opts ...InvokeOption) (*LookupApiResult, error)

Note: This function is named LookupApi in the Go SDK.

public static class GetApi {
    public static Task<GetApiResult> InvokeAsync(GetApiArgs args, InvokeOptions? opts = null)
}

The following arguments are supported:

ApiManagementName string: The name of the API Management Service in which the API Management API exists.
Name string: The name of the API Management API.
ResourceGroupName string: The Name of the Resource Group in which the API Management Service exists.
Revision string: The Revision of the API Management API.

ApiManagementName string: The name of the API Management Service in which the API Management API exists.
Name string: The name of the API Management API.
ResourceGroupName string: The Name of the Resource Group in which the API Management Service exists.
Revision string: The Revision of the API Management API.

apiManagementName string: The name of the API Management Service in which the API Management API exists.
name string: The name of the API Management API.
resourceGroupName string: The Name of the Resource Group in which the API Management Service exists.
revision string: The Revision of the API Management API.

api_management_name str: The name of the API Management Service in which the API Management API exists.
name str: The name of the API Management API.
resource_group_name str: The Name of the Resource Group in which the API Management Service exists.
revision str: The Revision of the API Management API.

GetApi Result

The following output properties are available:

ApiManagementName string
Description string: A description of the API Management API, which may include HTML formatting tags.
DisplayName string: The display name of the API.
Id string: The provider-assigned unique ID for this managed resource.
IsCurrent bool: Is this the current API Revision?
IsOnline bool: Is this API Revision online/accessible via the Gateway?
Name string
Path string: The Path for this API Management API.
Protocols List<string>: A list of protocols the operations in this API can be invoked.
ResourceGroupName string
Revision string
ServiceUrl string: Absolute URL of the backend service implementing this API.
SoapPassThrough bool: Should this API expose a SOAP frontend, rather than a HTTP frontend?
SubscriptionKeyParameterNames List<GetApiSubscriptionKeyParameterName>: A subscription_key_parameter_names block as documented below.
SubscriptionRequired bool: Should this API require a subscription key?
Version string: The Version number of this API, if this API is versioned.
VersionSetId string: The ID of the Version Set which this API is associated with.

ApiManagementName string
Description string: A description of the API Management API, which may include HTML formatting tags.
DisplayName string: The display name of the API.
Id string: The provider-assigned unique ID for this managed resource.
IsCurrent bool: Is this the current API Revision?
IsOnline bool: Is this API Revision online/accessible via the Gateway?
Name string
Path string: The Path for this API Management API.
Protocols []string: A list of protocols the operations in this API can be invoked.
ResourceGroupName string
Revision string
ServiceUrl string: Absolute URL of the backend service implementing this API.
SoapPassThrough bool: Should this API expose a SOAP frontend, rather than a HTTP frontend?
SubscriptionKeyParameterNames []GetApiSubscriptionKeyParameterName: A subscription_key_parameter_names block as documented below.
SubscriptionRequired bool: Should this API require a subscription key?
Version string: The Version number of this API, if this API is versioned.
VersionSetId string: The ID of the Version Set which this API is associated with.

apiManagementName string
description string: A description of the API Management API, which may include HTML formatting tags.
displayName string: The display name of the API.
id string: The provider-assigned unique ID for this managed resource.
isCurrent boolean: Is this the current API Revision?
isOnline boolean: Is this API Revision online/accessible via the Gateway?
name string
path string: The Path for this API Management API.
protocols string[]: A list of protocols the operations in this API can be invoked.
resourceGroupName string
revision string
serviceUrl string: Absolute URL of the backend service implementing this API.
soapPassThrough boolean: Should this API expose a SOAP frontend, rather than a HTTP frontend?
subscriptionKeyParameterNames GetApiSubscriptionKeyParameterName[]: A subscription_key_parameter_names block as documented below.
subscriptionRequired boolean: Should this API require a subscription key?
version string: The Version number of this API, if this API is versioned.
versionSetId string: The ID of the Version Set which this API is associated with.

api_management_name str
description str: A description of the API Management API, which may include HTML formatting tags.
display_name str: The display name of the API.
id str: The provider-assigned unique ID for this managed resource.
is_current bool: Is this the current API Revision?
is_online bool: Is this API Revision online/accessible via the Gateway?
name str
path str: The Path for this API Management API.
protocols List[str]: A list of protocols the operations in this API can be invoked.
resource_group_name str
revision str
service_url str: Absolute URL of the backend service implementing this API.
soap_pass_through bool: Should this API expose a SOAP frontend, rather than a HTTP frontend?
subscription_key_parameter_names List[GetApiSubscriptionKeyParameterName]: A subscription_key_parameter_names block as documented below.
subscription_required bool: Should this API require a subscription key?
version str: The Version number of this API, if this API is versioned.
version_set_id str: The ID of the Version Set which this API is associated with.

Supporting Types

GetApiSubscriptionKeyParameterName

See the output API doc for this type.

Header string: The name of the HTTP Header which should be used for the Subscription Key.
Query string: The name of the QueryString parameter which should be used for the Subscription Key.

Header string: The name of the HTTP Header which should be used for the Subscription Key.
Query string: The name of the QueryString parameter which should be used for the Subscription Key.

header string: The name of the HTTP Header which should be used for the Subscription Key.
query string: The name of the QueryString parameter which should be used for the Subscription Key.

header str: The name of the HTTP Header which should be used for the Subscription Key.
query str: The name of the QueryString parameter which should be used for the Subscription Key.

Package Details

Repository: https://github.com/pulumi/pulumi-azure
License: Apache-2.0
Notes: This Pulumi package is based on the azurerm Terraform Provider.

The Pulumi Platform

Get Started

Migrate to Pulumi

Solutions for All Teams and Engineers

Any Code

Any Cloud

GetApi

Example Usage

Using GetApi

GetApi Result

Supporting Types

GetApiSubscriptionKeyParameterName

Package Details

On This Page