Create Repository

Details

API DetailsRelease-Specific Information
CloudCenter Platform 4xCloudCenter Suite 5x
NameCreate Repository
Description

Creates a new repository for the specified tenant.

Allowed Role(s)WM_USER
MethodPOST
URI

repositories

cloudcenter-ccm-backend/api/repositories

Sample Request
curl -k -X POST -H "Accept: application/json" -H "Content-Type: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/repositories"
curl -k -X POST -H "Accept: application/json" -H "Content-Type: application/json" -u cliqradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/cloudcenter-ccm-backend/api/repositories"
Release
  • Introduced in CloudCenter 4.8

Modified in CloudCenter Suite 5.0.0

Notes
  • Only resource owners and users with WRITE perms can view all the fields for this resource.
  • Other users can only view common fields like name, description, and so forth. See Permission Control for additional context.
Back To LinksCloudCenter Platform 4x APIWorkload Manager API

ESB Header

action: create.repositories.service

See the Enterprise Service Bus (ESB) section for additional context.

Not applicable

Sample Request

{
   "perms":[
      "delete",
      "administration",
      "write",
      "read"
   ],
   "displayName":"Artifactory",
   "description":"Standard Artifactory Repository",
   "type":"ARTIFACTORY",
   "hostname":"artifactory.cliqrtech.com",
   "port":8081,
   "usernamePassword":{
      "username":"admin",
      "password":"===redacted==="
   },
   "sslCredential":{
      "privateKey":"",
      "certChain":"",
      "trustedCert":""
   },
   "bucketName":null,
   "region":null,
   "accessKey":null,
   "accessSecret":null,
   "chefUser":null,
   "chefUserKey":null,
   "trustedCert":null,
   "chefValidationKey":null,
   "certname":null,
   "bundleStore":false
}

Sample Response

{
   "id":"1",
   "resource":"https://<HOST>:<PORT>/repositories/1",
   "perms":[
      "delete",
      "administration",
      "write",
      "read"
   ],
   "displayName":"Artifactory",
   "description":"Standard Artifactory Repository",
   "type":"ARTIFACTORY",
   "hostname":"artifactory.cliqrtech.com",
   "port":8081,
   "usernamePassword":{
      "username":"admin",
      "password":"===redacted==="
   },
   "sslCredential":{
      "privateKey":"",
      "certChain":"",
      "trustedCert":""
   },
   "bucketName":null,
   "region":null,
   "accessKey":null,
   "accessSecret":null,
   "chefUser":null,
   "chefUserKey":null,
   "trustedCert":null,
   "chefValidationKey":null,
   "certname":null,
   "bundleStore":false
}

Request Attributes

repositoryId
  • Description: Unique, system-generated identifier for the repository.  See the Artifact Repository and the Create and Share Artifact Repositories sections for the relevant release for additional context. This ID refers to the location where the exported CloudCenter ZIP file is stored.
  • Type: String

perms (click for more information)

displayName
  • DescriptionA descriptive name for this CloudCenter resource.
  • Type: String

description
  • DescriptionA brief description for this CloudCenter Resource.

  • Type: String

type
  • DescriptionThe type of repository used in this environment.

  • Type: Enumeration

    EnumerationDescription
    ARTIFACTORY

    Provide the Hostname, Port, Username/Password or the SSL Credentials of your Artifact repository.

    See your repository documentation to set up your Artifact repository.

    FTP

    Use your own FTP repository for application artifacts. See Artifact Repository for additional details.

    Provide the Hostname, Port, Username/Password of your FTP repository.

    The CloudCenter platform only supports PASSIVE mode when using FTP repositories.

    HTTP

    Use your own HTTP repository for application artifacts. See Artifact Repository for additional details.

    Provide the Hostname, Port, and optionally, Username/Password of your HTTP repository.

    You can create HTTP repositories using Apache, Nginx or any other web server of your choice. You can then use HTTP repositories to host application artifacts.

    HTTPS

    Use your own HTTPS repository for application artifacts. See Artifact Repository for additional details.

    Provide the Hostname and Port. You can choose to provide the username/password or SSL credentials that comprise of the Private Key, Client/Trusted certificates of your HTTPS repository.

    AMAZON_S_3Provide the Region, Access Key, Access Secret for your AWS account, and the name of the S3 Bucket, that you would like to use as your repository.
    PUPPET

    The central server that manages Puppet Agent(s). Refer to http://docs.puppetlabs.com (install Puppet) for additional context. This option is only displayed if you use the Puppet service. Provide the Hostname (of the Puppet Master) and the Certname Suffix (authentication credentials for the Puppet Master).

    CHEF

    The central server that manages the Chef clients. Refer to https://docs.chef.io/ (install server) for additional context. Alternately, you can also use the free Chef server image provided in the AWS Marketplace. This option is only displayed if you use the Chef service.

    Provide the Hostname, Chef User Key, Chef Validation key and optionally Trusted Certificate of the Chef Server.

    If your Chef Server is configured with a Public DNS, add the Public DNS in the Hostname field and copy the public DNS to the Trusted Certificate field when creating or editing the repository.

hostName
  • Description: The DNS host name for this VM.

  • Type: String

port
  • Description: Identifies the port used by the Artifact Repository server or the Container.
  • Type: Integer

username
  • Description: Unique, CloudCenter-generated name reference for this user.
  • Type: String

password
  • Description: Password for the user's account. Effective Cloud Center 4.6.1, the CloudCenter platform enforces a minimum password length of 5 characters for all settings.
  • Type: String

sslCredential
  • Description: Identifies the type of SSL credentials for the repository.

  • Type: String

    privateKey
    • Description: You can provide the required repository credentials to authenticate the supported repositories by using secure access private key.

    • Type: String

    certChain
    • Description: You can provide the required repository credentials to authenticate the supported repositories by using secure access Client Certificate.

    • Type: String

    trustedCert
    • Description: You can provide the required repository credentials to authenticate the supported repositories by using secure access Trusted Certificate.

    • Type: String

bucketName
  • Description: The name of the S3 Bucket, that you would like to use as your Amazon S3 repository.

  • Type: String

region
  • Description: The name of the AWS region where your Amazon S3 repository is located.

  • Type: String

accessKey
  • Description: URL from where you can fetch access keys for each cloud region

  • Type: URL

accessSecret
  • Description: The authentication secret used to fetch the access key for each cloud region

  • Type: Long

chefUser
  • Description: If the Chef server is configured with SSL, specify the private key used to manage the Chef client.
  • Type: Long

chefUserKey
  • Description: If the Chef server is configured with SSL, specify the validation key used to authenticate the Chef Client.
  • Type: Long

trustedCert
  • Description: You can provide the required repository credentials to authenticate the supported repositories by using secure access Trusted Certificate.

  • Type: String

chefValidationKey
  • Description: If the Chef server is configured with SSL, specify the validation key used to authenticate the Chef Client when it communicates with the Chef Server for the first time. This setting is specific to the Chef service.

  • Type: Long

certname
  • Description: The SSL certificate of the Chef Server used to authenticate the Chef Client to the Chef Server.
  • Type: Long

bundleStore
  • Description: The Workload Manager local repo appliance is based on CentOS 7 and has an Apache web service and a version of the package store and bundle store preinstalled. You would deploy this appliance to your target VM-based cloud if either of these two conditions is true:

    • Your workload VMs cannot access the Cisco-hosted package store and bundle store.

    • Your want to reduce the latency associated with downloading files from the package store or bundle store.

    • See the Local Repo Appliance section for additional details.

  • Type: Boolean
    • true = This repository uses the local bundle store.
    • false = Default. This repository does not use the local bundle store.


Response Attributes

repositories
  • Description: Identifies attributes for stores and repositories. See Artifact Repository for additional context
  • Type: Array of mapped attribute

    id
    • DescriptionUnique, system-generated identifier for this CloudCenter Resource.

    • Type: String
    resource
    • Description: Unique URL to access this resource.
    • Type: String
    perms (click for additional details)
    displayName
    • DescriptionA descriptive name for this CloudCenter resource.
    • Type: String
    hostName
    • Description: The DNS host name for this VM.

    • Type: String
    protocol
    • Description: Defines the protocol to be used by VMs running this service.
    • Type: Enumeration:

      ProtocolDescription
      TCPTransmission Control Protocol
      UDPUser Datagram Protocol
    description
    • DescriptionA brief description for this CloudCenter Resource.

    • Type: String
    port
    • Description: Identifies the port used by the Artifact Repository server or the Container.
    • Type: Integer

  • No labels
Terms & Conditions Privacy Statement Cookies Trademarks