Package com.azure.resourcemanager.apimanagement.fluent

Interface ProductsClient

  • public interface ProductsClient
    An instance of this class provides access to all the operations defined in ProductsClient.

    • Method Detail

      • listByService

        com.azure.core.http.rest.PagedIterable<ProductContractInner> listByService​(String resourceGroupName,
                                                                           String serviceName)
        Lists a collection of products in the specified service instance.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        Returns:
        paged Products list representation as paginated response with PagedIterable.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • listByService

        com.azure.core.http.rest.PagedIterable<ProductContractInner> listByService​(String resourceGroupName,
                                                                           String serviceName,
                                                                           String filter,
                                                                           Integer top,
                                                                           Integer skip,
                                                                           Boolean expandGroups,
                                                                           String tags,
                                                                           com.azure.core.util.Context context)
        Lists a collection of products in the specified service instance.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        filter - | Field | Usage | Supported operators | Supported functions |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| terms | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| state | filter | eq | |</br>| groups | expand | | |</br>.
        top - Number of records to return.
        skip - Number of records to skip.
        expandGroups - When set to true, the response contains an array of groups that have visibility to the product. The default is false.
        tags - Products which are part of a specific tag.
        context - The context to associate with this operation.
        Returns:
        paged Products list representation as paginated response with PagedIterable.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • getEntityTag

        void getEntityTag​(String resourceGroupName,
                  String serviceName,
                  String productId)
        Gets the entity state (Etag) version of the product specified by its identifier.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • getEntityTagWithResponse

        ProductsGetEntityTagResponse getEntityTagWithResponse​(String resourceGroupName,
                                                      String serviceName,
                                                      String productId,
                                                      com.azure.core.util.Context context)
        Gets the entity state (Etag) version of the product specified by its identifier.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        context - The context to associate with this operation.
        Returns:
        the entity state (Etag) version of the product specified by its identifier.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • get

        ProductContractInner get​(String resourceGroupName,
                         String serviceName,
                         String productId)
        Gets the details of the product specified by its identifier.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        Returns:
        the details of the product specified by its identifier.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • getWithResponse

        ProductsGetResponse getWithResponse​(String resourceGroupName,
                                    String serviceName,
                                    String productId,
                                    com.azure.core.util.Context context)
        Gets the details of the product specified by its identifier.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        context - The context to associate with this operation.
        Returns:
        the details of the product specified by its identifier.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • createOrUpdate

        ProductContractInner createOrUpdate​(String resourceGroupName,
                                    String serviceName,
                                    String productId,
                                    ProductContractInner parameters)
        Creates or Updates a product.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        parameters - Create or update parameters.
        Returns:
        product details.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • createOrUpdateWithResponse

        ProductsCreateOrUpdateResponse createOrUpdateWithResponse​(String resourceGroupName,
                                                          String serviceName,
                                                          String productId,
                                                          ProductContractInner parameters,
                                                          String ifMatch,
                                                          com.azure.core.util.Context context)
        Creates or Updates a product.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        parameters - Create or update parameters.
        ifMatch - ETag of the Entity. Not required when creating an entity, but required when updating an entity.
        context - The context to associate with this operation.
        Returns:
        product details.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • update

        ProductContractInner update​(String resourceGroupName,
                            String serviceName,
                            String productId,
                            String ifMatch,
                            ProductUpdateParameters parameters)
        Update existing product details.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        ifMatch - ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update.
        parameters - Update parameters.
        Returns:
        product details.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • updateWithResponse

        ProductsUpdateResponse updateWithResponse​(String resourceGroupName,
                                          String serviceName,
                                          String productId,
                                          String ifMatch,
                                          ProductUpdateParameters parameters,
                                          com.azure.core.util.Context context)
        Update existing product details.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        ifMatch - ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update.
        parameters - Update parameters.
        context - The context to associate with this operation.
        Returns:
        product details.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • delete

        void delete​(String resourceGroupName,
            String serviceName,
            String productId,
            String ifMatch)
        Delete product.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        ifMatch - ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • deleteWithResponse

        com.azure.core.http.rest.Response<Void> deleteWithResponse​(String resourceGroupName,
                                                           String serviceName,
                                                           String productId,
                                                           String ifMatch,
                                                           Boolean deleteSubscriptions,
                                                           com.azure.core.util.Context context)
        Delete product.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        productId - Product identifier. Must be unique in the current API Management service instance.
        ifMatch - ETag of the Entity. ETag should match the current entity state from the header response of the GET request or it should be * for unconditional update.
        deleteSubscriptions - Delete existing subscriptions associated with the product or not.
        context - The context to associate with this operation.
        Returns:
        the Response.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • listByTags

        com.azure.core.http.rest.PagedIterable<TagResourceContractInner> listByTags​(String resourceGroupName,
                                                                            String serviceName)
        Lists a collection of products associated with tags.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        Returns:
        paged Tag list representation as paginated response with PagedIterable.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.

      • listByTags

        com.azure.core.http.rest.PagedIterable<TagResourceContractInner> listByTags​(String resourceGroupName,
                                                                            String serviceName,
                                                                            String filter,
                                                                            Integer top,
                                                                            Integer skip,
                                                                            Boolean includeNotTaggedProducts,
                                                                            com.azure.core.util.Context context)
        Lists a collection of products associated with tags.
        Parameters:
        resourceGroupName - The name of the resource group.
        serviceName - The name of the API Management service.
        filter - | Field | Usage | Supported operators | Supported functions |</br>|-------------|-------------|-------------|-------------|</br>| name | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| description | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| terms | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |</br>| state | filter | eq | substringof, contains, startswith, endswith |</br>.
        top - Number of records to return.
        skip - Number of records to skip.
        includeNotTaggedProducts - Include not tagged Products.
        context - The context to associate with this operation.
        Returns:
        paged Tag list representation as paginated response with PagedIterable.
        Throws:
        IllegalArgumentException - thrown if parameters fail the validation.
        com.azure.core.management.exception.ManagementException - thrown if the request is rejected by server.
        RuntimeException - all other wrapped checked exceptions if the request fails to be sent.